dpns_undelete man page

DPNS_UNDELETE(3)            DPNS Library Functions            DPNS_UNDELETE(3)

[1mNAME[0m
      dpns_undelete - recover a logically deleted DPNS file entry in the name
      server

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "dpns_api.h"[0m

      [1mint dpns_undelete (const char *[4m[22mpath[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_undelete  [22mrecovers  a  DPNS  file  entry  logically   deleted   by
      [1mdpns_delete[22m.  This can be done as long as a the reclaim utility has not
      been run on the corresponding tape volume.

      [4mpath[24m   specifies the logical pathname  relative  to  the  current  DPNS
             directory or the full DPNS pathname.

[1mRETURN VALUE[0m
      This  routine  returns  0  if the operation was successful or -1 if the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mEPERM        [4m[22mpath[24m is a directory.

      [1mENOENT       [22mThe named file does not exist or is a null pathname.

      [1mEACCES       [22mSearch permission is denied on a  component  of  the  [4mpath[0m
                   prefix  or write permission is denied on the parent direc-
                   tory or the parent has the sticky bit S_ISVTX set and

                     the effective user ID of the requestor  does  not  match
                     the owner ID of the file and

                     the  effective  user  ID of the requestor does not match
                     the owner ID of the directory and

                     the file is not writable by the requestor and

                     the requestor does not have ADMIN privilege in the  Cupv
                     database.

      [1mEFAULT       [4m[22mpath[24m is a NULL pointer.

      [1mENOTDIR      [22mA component of [4mpath[24m prefix is not a directory.

      [1mENAMETOOLONG [22mThe  length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length of
                   a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mENSNACT      [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m, [1mdpns_chdir(3)[22m, [1mdpns_delete(3)[22m, [1mCupvlist(1)[0m

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

DPNS                     $Date: 2002/10/16 06:25:40 $         DPNS_UNDELETE(3)