gfs_pio_set_view_index(3) [debian man page]

GFS_PIO_SET_VIEW_INDEX(3)												 GFS_PIO_SET_VIEW_INDEX(3)

NAME

       gfs_pio_set_view_index - change file view to an individual fragment

SYNOPSIS

       #include <gfarm/gfarm.h>

       char *gfs_pio_set_view_index (GFS_File gf, int fragment_number, int fragment_index, char *host, int flags);

DESCRIPTION

       gfs_pio_set_view_index()  changes  the  process's  view	of  the  data  in the file specified by gf to a file fragment with the index frag-
       ment_index.

       When creating a new file, it is necessary to specify the total number of file fragments fragment_number.   Every  parallel  process  should
       specify the same fragment_number for the corresponding file.  When the file exists, GFARM_FILE_DONTCARE can be specified.  If fragment_num-
       ber is different from the total fragment number of the existent file, it is erroneous.

       host is used for explicitly specifying a filesystem node.  If host is NULL, appropriate filesystem node is chosen.

       Values of flag are constructed by a bitwise-inclusive-OR of the following list.

       GFARM_FILE_SEQUENTIAL
	      File will be accessed sequentially.

       GFARM_FILE_REPLICATE
	      File may be replicated to a local filesystem when accessing remotely.  This flag cannot be specified with GFARM_FILE_NOT_REPLICATE.

       GFARM_FILE_NOT_REPLICATE
	      File may not be replicated to a local filesystem when accessing remotely.  This flag cannot be specified with GFARM_FILE_REPLICATE.

       By default, Gfarm files are accessed as a whole file in global file view where each fragment can be seamlessly accessed.

RETURN VALUES

       NULL   The function terminated successfully.

       GFARM_ERR_NO_MEMORY
	      Insufficient memory was available.

       GFARM_ERR_OPERATION_NOT_PERMITTED
	      The file is not a regular fragmented file.

       GFARM_ERR_FRAGMENT_NUMBER_DOES_NOT_MATCH
	      The total number of file fragments is different from the existence one.

       GFARM_ERR_INVALID_ARGUMENT
	      Invalid arguments are specified, for instance, GFARM_FILE_DONTCARE is specified as the total number of fragments of a newly  created
	      file.

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

SEE ALSO

       gfs_pio_create(3), gfs_pio_open(3), gfs_pio_set_view_local(3)

Gfarm								 06 September 2005					 GFS_PIO_SET_VIEW_INDEX(3)

GFS_PIO_GETS(3) 														   GFS_PIO_GETS(3)

NAME

       gfs_pio_gets - read one line

SYNOPSIS

       #include <gfarm/gfarm.h>

       char *gfs_pio_gets (GFS_File f, char * s, size_t size);

DESCRIPTION

       gfs_pio_gets()  reads one line from the file specified by the parameter gf to the buffer specified by the parameter s.  You need to specify
       the size of the buffer by the parameter size.

       Unlike gfs_pio_getline(3), this function doesn't remove newline character at the end of the buffer. But if whole contents of the line  can-
       not  be	stored to the buffer due to its length, or if the file reaches the end without newline, there will be no newline at the end of the
       buffer. In any case, one '' character is appended to the end of the buffer.

       If the file reaches its end, the length of the string in the buffer becomes 0.

RETURN VALUES

       NULL   The function terminated successfully.

       GFARM_ERR_NO_MEMORY
	      Insufficient memory was available.

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

EXAMPLES

   EXAMPLE OF GFS_PIO_GETS FUNCTION
       #include <stdio.h>
       #include <stdlib.h>
       #include <gfarm/gfarm.h>

       int
       main(int argc, char **argv)
       {
	    char *e;
	    GFS_File gf;
	    char buffer[512];

	    e = gfarm_initialize(&argc, &argv);
	    if (e != NULL) {
		 fprintf(stderr, "gfarm_initialize: %s
", e);
		 return (EXIT_FAILURE);
	    }
	    if (argc <= 1) {
		 fprintf(stderr, "missing gfarm filename
");
		 return (EXIT_FAILURE);
	    }
	    e = gfs_pio_open(argv[1], GFARM_FILE_RDONLY, &gf);
	    if (e != NULL) {
		 fprintf(stderr, "%s: %s
", argv[1], e);
		 return (EXIT_FAILURE);
	    }
	    e = gfs_pio_set_view_global(gf, 0);
	    if (e != NULL) {
		 fprintf(stderr, "%s: gfs_pio_set_view_global: %s
",
		     argv[1], e);
		 return (EXIT_FAILURE);
	    }

	    while ((e = gfs_pio_gets(gf, buffer, sizeof buffer)) != NULL &&
		*buffer != '') {
		 printf("got: %s", buffer);
	    }
	    if (e != NULL) {
		 fprintf(stderr, "ERROR: %s
", e);
		 return (EXIT_FAILURE);
	    }
	    e = gfs_pio_close(gf);
	    if (e != NULL) {
		 fprintf(stderr, "gfs_pio_close: %s
", e);
		 return (EXIT_FAILURE);
	    }
	    e = gfarm_terminate();
	    if (e != NULL) {
		 fprintf(stderr, "gfarm_initialize: %s
", e);
		 return (EXIT_FAILURE);
	    }
	    return (EXIT_SUCCESS);
       }

SEE ALSO

       gfs_pio_open(3), gfs_pio_getline(3), gfs_pio_readline(3), gfs_pio_readdelim(3)

Gfarm								    13 May 2004 						   GFS_PIO_GETS(3)