lfc-dli(8) [debian man page]

LFC-DLI(8)						    LFC Administrator Commands							LFC-DLI(8)

NAME

       lfc-dli - start the LFC Data Location Interface server

SYNOPSIS

       lfc-dli [ -l log_file ]

DESCRIPTION

       The  lfc-dli  command  starts  the  LFC	Data  Location	Interface  server.   This  command  is	usually  executed  at  system startup time
       (/etc/rc.local).  This will create a pool of threads, look for requests and pass them to the LFC.  When a request has been  completed,  the
       thread becomes idle until it is allocated to another request.

       All error messages and statistical information are kept in a log.

       The  Data  Location  Interface server listen port number can be defined on client hosts and on the server itself in either of the following
       ways:

	      setting an environment variable DLI_PORT

		     setenv DLI_PORT 8085

	      an entry in /etc/shift.conf like:

		     DLI  PORT 8085

       If none of these methods is used, the default port number is taken from the definition of DLI_PORT in dli_server.h.

       In the log each entry has a timestamp.  For each user request there is one message giving information about the	requestor  (hostname)  and
       one message DLI98 giving the request itself.  The completion code of the request is also logged.

OPTIONS

       -l log_file
	      Specifies a different path for the LFC Data Location Interface server log file.  The special value syslog will send the log messages
	      to the system logger syslogd.

FILES

       /var/log/lfc-dli/log

EXAMPLES

       Here is a small log:
	      05/18 16:27:21  1942 dli: started
	      05/18 22:10:33  1942,0 listReplicas: request from lxb2016.cern.ch
	      05/18 22:10:33  1942,0 listReplicas: DLI98 - listReplicas lfn:/grid/dteam/foo888
	      05/18 22:10:34  1942,0 listReplicas: returns 0
	      05/18 22:12:10  1942,0 listReplicas: request from lxb2016.cern.ch
	      05/18 22:12:10  1942,0 listReplicas: DLI98 - listReplicas guid:41b20a76-2287-4f81-9750-7e2eb4d199c8
	      05/18 22:12:11  1942,0 listReplicas: returns 0

SEE ALSO

       Clogit(3), lfc-server(8)

LCG
								      $Date$								LFC-DLI(8)

LFC_GETACL(3)						       LFC Library Functions						     LFC_GETACL(3)

NAME

       lfc_getacl - get LFC directory/file access control lists

SYNOPSIS

       #include <sys/types.h>
       #include "lfc_api.h"

       int lfc_getacl (const char *path, int nentries, struct lfc_acl *acl)

DESCRIPTION

       lfc_getacl gets the Access Control List associated with a LFC directory/file.

       path   specifies the logical pathname relative to the current LFC directory or the full LFC pathname.

       nentries
	      specifies  the  number  of entries that can fit in the buffer. If nentries is zero, the acl pointer can be NULL and the routine just
	      returns the actual number of entries.

       acl    is a pointer to an array of lfc_acl structures allocated by the application to receive the reply.

       struct lfc_acl {
	       unsigned char   a_type;
	       int	       a_id;
	       unsigned char   a_perm;
       };

       a_type is the ACL type: CNS_ACL_USER_OBJ, CNS_ACL_USER, CNS_ACL_GROUP_OBJ, CNS_ACL_GROUP, CNS_ACL_MASK or CNS_ACL_OTHER.  Types for default
	      entries are obtained by OR'ing the flag CNS_ACL_DEFAULT with one of the above types.

       a_id   is the user or group numeric id.

       a_perm is the access permission in numeric form obtained by OR'ing some of the bits S_IROTH, S_IWOTH, S_IXOTH.

RETURN VALUE

       This routine returns the actual number of entries if the operation was successful or -1 if the operation failed. In the latter case, serrno
       is set appropriately.

ERRORS

       ENOENT	    The named file/directory does not exist or is a null pathname.

       EACCES	    Search permission is denied on a component of the path prefix.

       EFAULT	    path is a NULL pointer or acl is a NULL pointer and nentries is greater than zero.

       ENOTDIR	    A component of path prefix is not a directory.

       EINVAL	    nentries is negative.

       ENOSPC	    nentries is less than the number of entries returned by the server.

       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length of a path component exceeds CA_MAXNAMELEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT	    Name server is not running or is being shutdown.

SEE ALSO

       Castor_limits(4), lfc_chdir(3), lfc_chmod(3), lfc-getacl(1)

AUTHOR

       LCG Grid Deployment Team

LFC
							   $Date: 2003/04/08 05:37:53 $ 					     LFC_GETACL(3)