User talk:Debankur

Revision as of 14:04, 18 October 2006 by Debankur (talk | contribs)


DESCRIPTION


FUNCTION CALLS :

NAME : gpfs_getacl()

FUNCTION :

Retrieves the ACL information for a file. This function, together with gpfs_putacl, is intended for use by a backup program to save (gpfs_getacl) and restore (gpfs_putacl) the ACL information for a file. The flags parameter must be zero (reserved for future use). The aclP parameter must point to a buffer mapped by the gpfs_opaque_acl_t structure. The first four bytes of the buffer must contain its total size.

Note: The use of gpfs_fgetattrs/gpfs_fputattrs is preferred.

FUNCTION PROTOTYPE :

   int gpfs_getacl(char *pathname, int flags, void *acl);

RETURNS :

     0      Successful
    -1      Failure

ERROR :

    ENOSYS  function not available
    ENOSPC  buffer too small to return the entire ACL. 
            Needed size is returned in the first four bytes of the buffer pointed to by aclP.


NAME : gpfs_putacl()

FUNCTION :

Sets the ACL information for a file. The buffer passed in should contain the ACL data that was obtained by a previous call to gpfs_getacl. The flags parameter must be zero (reserved for future use).

Note: The use of gpfs_fgetattrs/gpfs_fputattrs is preferred.

FUNCTION PROTOTYPE :

  int gpfs_putacl(char *pathname, int   flags, void *acl);

RETURNS :

     0      Successful
    -1      Failure

ERROR :

    ENOSYS  function not available


NAME : gpfs_set_share()

FUNCTION :

Acquire shares for Samba

      Input :
            fd    : file descriptor
            allow : share type being requested
                    GPFS_SHARE_NONE, GPFS_SHARE_READ,
                    GPFS_SHARE_WRITE, GPFS_SHARE_BOTH
            deny  : share type to deny to others
                    GPFS_DENY_NONE, GPFS_DENY_READ,
                    GPFS_DENY_WRITE, GPFS_DENY_BOTH

FUNCTION PROTOTYPE :

   int gpfs_set_share(int fd, unsigned int allow, unsigned int deny);
   allow/deny specifications
   #define GPFS_SHARE_NONE   0
   #define GPFS_SHARE_READ   1
   #define GPFS_SHARE_WRITE  2
   #define GPFS_SHARE_BOTH   3
   #define GPFS_DENY_NONE    0
   #define GPFS_DENY_READ    1
   #define GPFS_DENY_WRITE   2
   #define GPFS_DENY_BOTH    3

RETURNS :

     0      Successful
    -1      Failure

ERROR :

   Specific error indication
   EACCES  share mode not available


NAME : gpfs_set_lease()

FUNCTION :

Acquire leases for Samba

   Input :
         fd        : file descriptor
         leaseType : lease type being requested
                     GPFS_LEASE_NONE GPFS_LEASE_READ,
                     GPFS_LEASE_WRITE

FUNCTION PROTOTYPE :

  int gpfs_set_lease(int fd, unsigned int leaseType);
     /* leaseType specifications */
     #define GPFS_LEASE_NONE    0
     #define GPFS_LEASE_READ    1
     #define GPFS_LEASE_WRITE   2

RETURNS :

     0      Successful
    -1      Failure

ERROR :

   Specific error indication
   EACCES  lease not available


NAME : gpfs_get_lease()

FUNCTION :

   Returns the type of lease currently held

FUNCTION PROTOTYPE :

  int gpfs_get_lease(int fd);

Returns :

       GPFS_LEASE_READ
       GPFS_LEASE_WRITE
       GPFS_LEASE_NONE
       -1      Failure

ERROR :

   Specific error indication
   EINVAL


DOWNLOAD LINK :

http://www14.software.ibm.com/webapp/set2/sas/f/gpfs/download/home.html

LICENSE :