User talk:Debankur: Difference between revisions

From SambaWiki
No edit summary
No edit summary
Line 1: Line 1:
<td>
<div id="toctitle">


'''<u>DESCRIPTION</u>'''


'''<u>FUNCTION CALLS : </u>'''

''NAME : '' <b> gpfs_getacl() </b>

''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 :'' <b> gpfs_putacl() </b>

''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 :'' <b> gpfs_set_share() </b>

''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 :'' <b> gpfs_set_lease() </b>

''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 :'' <b> gpfs_get_lease() </b>

''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


<u>'''DOWNLOAD LINK : '''</u>

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

<u>'''LICENSE :'''</u>

Revision as of 14:11, 18 October 2006