strtofflags(3) BSD Library Functions Manual strtofflags(3)
NAME
fflagstostr, strtofflags -- convert between file flag bits and their
string names
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <unistd.h>
char *
fflagstostr(unsigned long flags);
int
strtofflags(char **stringp, unsigned long *setp, unsigned long *clrp);
DESCRIPTION
The fflagstostr() function returns a comma separated string of the file
flags represented by flags. If no flags are set a zero length string is
returned.
If memory cannot be allocated for the return value, fflagstostr() returns
NULL.
The value returned from fflagstostr() is obtained from malloc() and
should be returned to the system with free() when the program is done
with it.
The strtofflags() function takes a string of file flags, as described in
chflags(1), parses it, and returns the 'set' flags and 'clear' flags such
as would be given as arguments to chflags(2). On success strtofflags()
returns 0, otherwise it returns non-zero and stringp is left pointing to
the offending token.
ERRORS
The fflagstostr() function may fail and set errno for any of the errors
specified for the library routine malloc(3).
SEE ALSO
chflags(1), chflags(2), malloc(3)
HISTORY
The fflagstostr() and strtofflags() functions first appeared in
FreeBSD 4.0.
BSD January 1, 2000 BSD
Mac OS X 10.8 - Generated Fri Aug 31 07:31:36 CDT 2012