Section 3: library functions
NAME Reading/Writing – Both the globus_xio_register_read() and globus_xio_register_write() calls follow similar semantics as described below. Both the globus_xio_register_read() and globus_xio_register_write() calls follow similar semantics as described below. If the waitforbytes parameter is greater than zero, the io will happen asynchronously and be completed when at least waitforbytes has been read/written. If the waitforbytes parameter is…
NAME Opening/Closing – An XIO handle with the file driver can be created with globus_xio_handle_create(). An XIO handle with the file driver can be created with globus_xio_handle_create(). If there is no handle set on the attr passed to the globus_xio_open() call, it performs the equivalent of an open() call. In this case, the contact string…
NAME Env Variables – The file driver uses the following environment variables * GLOBUS_XIO_FILE_DEBUG Available if using a debug build. The file driver uses the following environment variables * GLOBUS_XIO_FILE_DEBUG Available if using a debug build. See globus_debug.h for format. The File driver defines the levels TRACE for all function call tracing and INFO…
NAME Attributes and Cntls – File driver specific attrs and cntls. Enumerations enum globus_xio_file_attr_cmd_t { GLOBUS_XIO_FILE_SET_MODE, GLOBUS_XIO_FILE_GET_MODE, GLOBUS_XIO_FILE_SET_FLAGS, GLOBUS_XIO_FILE_GET_FLAGS, GLOBUS_XIO_FILE_SET_TRUNC_OFFSET, GLOBUS_XIO_FILE_GET_TRUNC_OFFSET, GLOBUS_XIO_FILE_SET_HANDLE, GLOBUS_XIO_FILE_GET_HANDLE, GLOBUS_XIO_FILE_SET_BLOCKING_IO, GLOBUS_XIO_FILE_GET_BLOCKING_IO, GLOBUS_XIO_FILE_SEEK } Functions globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_FILE_SET_MODE, int mode) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_FILE_GET_MODE, int *mode_out) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_FILE_SET_FLAGS, int flags) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_FILE_GET_FLAGS, int…
NAME getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked – nonlocking stdio functions SYNOPSIS #include <stdio.h> int getc_unlocked(FILE *stream); int getchar_unlocked(void); int putc_unlocked(int c, FILE *stream); int putchar_unlocked(int c); void clearerr_unlocked(FILE *stream); int feof_unlocked(FILE *stream); int ferror_unlocked(FILE *stream); int fileno_unlocked(FILE *stream); int fflush_unlocked(FILE *stream); int fgetc_unlocked(FILE *stream); int fputc_unlocked(int c, FILE *stream); size_t fread_unlocked(void *ptr, size_t size, size_t n,…
NAME fgetws – read a wide-character string from a FILE stream SYNOPSIS #include <wchar.h> wchar_t *fgetws(wchar_t *ws, int n, FILE *stream); DESCRIPTION The fgetws() function is the wide-character equivalent of the fgets(3) function. It reads a string of at most n-1 wide characters into the wide-character array pointed to by ws, and adds a terminating…
NAME fgetwln – get a line of wide characters from a stream LIBRARY Lb libbsd SYNOPSIS In stdio.h In bsd/wchar.h Ft wchar_t * Fn fgetwln FILE * restrict stream size_t * restrict len DESCRIPTION The Fn fgetwln function returns a pointer to the next line from the stream referenced by Fa stream . This line…
NAME getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked – nonlocking stdio functions SYNOPSIS #include <stdio.h> int getc_unlocked(FILE *stream); int getchar_unlocked(void); int putc_unlocked(int c, FILE *stream); int putchar_unlocked(int c); void clearerr_unlocked(FILE *stream); int feof_unlocked(FILE *stream); int ferror_unlocked(FILE *stream); int fileno_unlocked(FILE *stream); int fflush_unlocked(FILE *stream); int fgetc_unlocked(FILE *stream); int fputc_unlocked(int c, FILE *stream); size_t fread_unlocked(void *ptr, size_t size, size_t n,…
NAME fgetwc, getwc – read a wide character from a FILE stream SYNOPSIS #include <stdio.h> #include <wchar.h> wint_t fgetwc(FILE *stream); wint_t getwc(FILE *stream); DESCRIPTION The fgetwc() function is the wide-character equivalent of the fgetc(3) function. It reads a wide character from stream and returns it. If the end of stream is reached, or if ferror(stream)…
NAME getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, fgetspent, fgetspent_r, sgetspent, sgetspent_r, putspent, lckpwdf, ulckpwdf – get shadow password file entry SYNOPSIS /* General shadow password file API */ #include <shadow.h> struct spwd *getspnam(const char *name); struct spwd *getspent(void); void setspent(void); void endspent(void); struct spwd *fgetspent(FILE *stream); struct spwd *sgetspent(const char *s); int putspent(const struct spwd…
NAME getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, fgetspent, fgetspent_r, sgetspent, sgetspent_r, putspent, lckpwdf, ulckpwdf – get shadow password file entry SYNOPSIS /* General shadow password file API */ #include <shadow.h> struct spwd *getspnam(const char *name); struct spwd *getspent(void); void setspent(void); void endspent(void); struct spwd *fgetspent(FILE *stream); struct spwd *sgetspent(const char *s); int putspent(const struct spwd…
NAME getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked – nonlocking stdio functions SYNOPSIS #include <stdio.h> int getc_unlocked(FILE *stream); int getchar_unlocked(void); int putc_unlocked(int c, FILE *stream); int putchar_unlocked(int c); void clearerr_unlocked(FILE *stream); int feof_unlocked(FILE *stream); int ferror_unlocked(FILE *stream); int fileno_unlocked(FILE *stream); int fflush_unlocked(FILE *stream); int fgetc_unlocked(FILE *stream); int fputc_unlocked(int c, FILE *stream); size_t fread_unlocked(void *ptr, size_t size, size_t n,…
NAME fgetc, fgets, getc, getchar, ungetc – input of characters and strings SYNOPSIS #include <stdio.h> int fgetc(FILE *stream); char *fgets(char *s, int size, FILE *stream); int getc(FILE *stream); int getchar(void); int ungetc(int c, FILE *stream); DESCRIPTION fgetc() reads the next character from stream and returns it as an unsigned char cast to an int, or…
NAME getpwent_r, fgetpwent_r – get passwd file entry reentrantly SYNOPSIS #include <pwd.h> int getpwent_r(struct passwd *pwbuf, char *buf, size_t buflen, struct passwd **pwbufp); int fgetpwent_r(FILE *stream, struct passwd *pwbuf, char *buf, size_t buflen, struct passwd **pwbufp); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): getpwent_r(), Since glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 and earlier: _BSD_SOURCE || _SVID_SOURCE…
NAME fgetpwent – get password file entry SYNOPSIS #include <pwd.h> #include <stdio.h> #include <sys/types.h> struct passwd *fgetpwent(FILE *stream); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): fgetpwent(): Since glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 and earlier: _SVID_SOURCE DESCRIPTION The fgetpwent() function returns a pointer to a structure containing the broken out fields of a line in…
NAME fgetpos, fseek, fsetpos, ftell, rewind – reposition a stream SYNOPSIS #include <stdio.h> int fseek(FILE *stream, long offset, int whence); long ftell(FILE *stream); void rewind(FILE *stream); int fgetpos(FILE *stream, fpos_t *pos); int fsetpos(FILE *stream, const fpos_t *pos); DESCRIPTION The fseek() function sets the file position indicator for the stream pointed to by stream. The new…
NAME fgetln – get a line from a stream LIBRARY Lb libbsd SYNOPSIS In bsd/stdio.h Ft char * Fn fgetln FILE *stream size_t *len DESCRIPTION The Fn fgetln function returns a pointer to the next line from the stream referenced by Fa stream . This line is not a C string as it does not…
NAME getgrent_r, fgetgrent_r – get group file entry reentrantly SYNOPSIS #include <grp.h> int getgrent_r(struct group *gbuf, char *buf, size_t buflen, struct group **gbufp); int fgetgrent_r(FILE *stream, struct group *gbuf, char *buf, size_t buflen, struct group **gbufp); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): getgrent_r(): _GNU_SOURCE fgetgrent_r(): Since glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 and earlier:…
NAME fgetgrent – get group file entry SYNOPSIS #include <grp.h> #include <stdio.h> #include <sys/types.h> struct group *fgetgrent(FILE *stream); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): fgetgrent(): Since glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 and earlier: _SVID_SOURCE DESCRIPTION The fgetgrent() function returns a pointer to a structure containing the group information from the file referred to…
NAME getfilecon, fgetfilecon, lgetfilecon – get SELinux security context of a file SYNOPSIS #include <selinux/selinux.h> int getfilecon(const char *path, char **con); int getfilecon_raw(const char *path, char **con); int lgetfilecon(const char *path, char **con); int lgetfilecon_raw(const char *path, char **con); int fgetfilecon(int fd, char **con); int fgetfilecon_raw(int fd, char **con); DESCRIPTION getfilecon() retrieves the context associated…