Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gfarm_initialize(3) [debian man page]

GFARM_INITIALIZE(3)													       GFARM_INITIALIZE(3)

NAME

       gfarm_initialize - initialize the Gfarm execution environment for client

SYNOPSIS

       #include <gfarm/gfarm.h>

       gfarm_error_t gfarm_initialize (int *argcp, char *** argvp);

DESCRIPTION

       gfarm_initialize()  initializes	the  Gfarm  execution environment for client application.  This function should be called before any Gfarm
       library API.  argcp is a pointer to the number of arguments and argvp is a pointer to the argument vector.

RETURN VALUES

       GFARM_ERR_NO_ERROR
	      The function terminated successfully.

       GFARM_ERR_NO_MEMORY
	      Insufficient memory was available.

       GFARM_ERR_UNKNOWN_HOST
	      The metadata server cannot be resolved.

       GFARM_ERR_NETWORK_IS_UNREACHABLE
	      Network is unrechable.

       GFARM_ERR_OPERATION_TIMED_OUT
	      Connetion timeout occurs.

       GFARM_ERR_PROTOCOL
	      Protocol error occurs.

       GFARM_ERR_BROKEN_PIPE
	      Connection to the metadata server is broken.

       GFARM_ERR_PERMISSION_DENIED
	      The requested access to the file is not allowed, or one of the directories in gfarm_url did not allow search  (execute)  permission.
	      Or, the authentication to the metadata server fails.

       GFARM_ERR_PROTOCOL_NOT_SUPPORTED
	      Specified authentication protocol is not supported.

       GFARM_ERR_AUTHENTICATION
	      User authentication failed when connecting to the metadata server.

       Others An error except the above occurred.  The reason is shown by its gfarm_error_string(3).

SEE ALSO

       gfarm_terminate(3)

Gfarm								   26 June 2010 					       GFARM_INITIALIZE(3)

Check Out this Related Man Page

GFS_UTIMES(3)															     GFS_UTIMES(3)

NAME

       gfs_utimes - set file access and modification times

SYNOPSIS

       #include <gfarm/gfarm.h>

       char *gfs_utimes (const char * gfarm_url, const struct gfarm_timespec * tsp);

DESCRIPTION

       gfs_utimes() sets the access and modification times of the file pointed to by the gfarm_url argument to the value of the tsp argument.  The
       tsp argument is an array of gfarm_timespec structures.  The first array member represents the access time, and the second member represents
       the modification time.  The gfarm_timespec structure is:

	    struct gfarm_timespec {
		 unsigned int tv_sec;	  /* seconds */
		 unsigned int tv_nsec;	  /* nanoseconds */
	    };

       If the tsp argument is a null pointer, the access and modification times of the file are set to the current time.

RETURN VALUES

       NULL   The function terminated successfully.

       GFARM_ERR_GFARM_URL_PREFIX_IS_MISSING
	      gfarm_url does not start with the gfarm: prefix.

       GFARM_ERR_NO_MEMORY
	      Insufficient memory was available.

       GFARM_ERR_AUTHENTICATION
	      User authentication failed when connecting to gfmd(8).

       GFARM_ERR_PERMISSION_DENIED
	      gfarm_url points outside your accessible address space.

       GFARM_ERR_NO_SUCH_OBJECT
	      gfarm_url does not exist.

       Others An error except the above occurred.  The reason is shown by its pointed strings.

SEE ALSO

       gfs_stat(3)

Gfarm								 04 December 2003						     GFS_UTIMES(3)
Man Page