Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dpm_put(3) [debian man page]

DPM_PUT(3)						       DPM Library Functions							DPM_PUT(3)

NAME

       dpm_put - make a set of existing files available for I/O

SYNOPSIS

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

       int  dpm_put  (int  nbreqfiles,	struct	dpm_putfilereq	*reqfiles, int nbprotocols, char **protocols, char *u_token, int overwrite, time_t
       retrytime, char *r_token, int *nbreplies, struct dpm_putfilestatus **filestatuses)

DESCRIPTION

       dpm_put makes a set of existing files available for I/O.

       The input arguments are:

       nbreqfiles
	      specifies the number of files belonging to the request.

       reqfiles
	      specifies the array of file requests (dpm_putfilereq structures).

       struct dpm_putfilereq {
	    char      *to_surl;
	    time_t    lifetime;
	    time_t    f_lifetime;
	    char      f_type;
	    char      s_token[CA_MAXDPMTOKENLEN+1];
	    char      ret_policy;
	    char      ac_latency;
	    u_signed64	   requested_size;
       };

       nbprotocols
	      specifies the number of protocols.

       protocols
	      specifies the array of protocols.

       u_token
	      specifies the user provided description associated with the request.

       overwrite
	      if set to 1, it allows to overwrite an existing file.

       retrytime
	      This field is currently ignored.

       The output arguments are:

       r_token
	      Address of a buffer to receive the system allocated token.  The buffer must be at least CA_MAXDPMTOKENLEN+1 characters long.

       nbreplies
	      will be set to the number of replies in the array of file statuses.

       filestatuses
	      will be set to the address of an array of dpm_putfilestatus structures allocated by the API. The client application  is  responsible
	      for freeing the array when not needed anymore.

       struct dpm_putfilestatus {
	    char      *to_surl;
	    char      *turl;
	    u_signed64	   filesize;
	    int       status;
	    char      *errstring;
	    time_t    pintime;
	    time_t    f_lifetime;
       };

RETURN VALUE

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

ERRORS

       EFAULT	    reqfiles, protocols, r_token, nbreplies or filestatuses is a NULL pointer.

       ENOMEM	    Memory could not be allocated for marshalling the request.

       EINVAL	    nbreqfiles	or  nbprotocols is not strictly positive, the protocols are not supported, the length of the user request descrip-
		    tion is greater than 255 or all file requests have errors.

       SENOSHOST    Host unknown.

       SEINTERNAL   Database error.

       SECOMERR     Communication error.

LCG
							   $Date: 2006/12/20 15:21:57 $ 						DPM_PUT(3)

Check Out this Related Man Page

LFC_GETREPLICASS(3)					       LFC Library Functions					       LFC_GETREPLICASS(3)

NAME

       lfc_getreplicass - get the replica entries associated with a list of sfns

SYNOPSIS

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

       int lfc_getreplicass (int nbsfns, const char **sfns, int *nbentries, struct lfc_filereplicas **rep_entries)

DESCRIPTION

       lfc_getreplicass gets the replica entries associated with a list of sfns.

       nbsfns specifies the number of path names in the array sfns.

       sfns   specifies the list of Site File Names.

       nbentries
	      will be set to the number of entries in the array of replicas.

       rep_entries
	      will  be	set  to the address of an array of lfc_filereplicas structures allocated by the API. The client application is responsible
	      for freeing the array when not needed anymore.

       struct lfc_filereplicas {
	    char      guid[CA_MAXGUIDLEN+1];
	    int       errcode;
	    u_signed64	   filesize;
	    time_t	   ctime;	  /* GUID creation time */
	    char      csumtype[3];
	    char      csumvalue[33];
	    time_t	   r_ctime;  /* replica creation time */
	    time_t	   r_atime;  /* last access to replica */
	    char      status;
	    char      host[CA_MAXHOSTNAMELEN+1];
	    char      sfn[CA_MAXSFNLEN+1];
       };

RETURN VALUE

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

ERRORS

       ENOENT	    The named file does not exist.

       ENOMEM	    Memory could not be allocated for marshalling the request or unmarshalling the reply.

       EFAULT	    sfns, nbentries or rep_entries is a NULL pointer.

       EINVAL	    nbsfns is not strictly positive.

       ENAMETOOLONG The length of sfn exceeds CA_MAXSFNLEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SEINTERNAL   Database error.

       SECOMERR     Communication error.

       ENSNACT	    Name server is not running or is being shutdown.

SEE ALSO

       Castor_limits(4), lfc_chdir(3)

AUTHOR

       LCG Grid Deployment Team

LFC
					       $Date: 2010-09-13 07:52:37 +0200 (Mon, 13 Sep 2010) $			       LFC_GETREPLICASS(3)
Man Page