Documentation Archive Developer
ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages


This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

STRTOFFLAGS(3)           BSD Library Functions Manual           STRTOFFLAGS(3)

     fflagstostr, strtofflags -- convert between file flag bits and their
     string names

     Standard C Library (libc, -lc)

     #include <unistd.h>

     char *
     fflagstostr(unsigned long flags);

     strtofflags(char **stringp, unsigned long *setp, unsigned long *clrp);

     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

     If memory cannot be allocated for the return value, fflagstostr() returns

     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.

     The fflagstostr() function may fail and set errno for any of the errors
     specified for the library routine malloc(3).

     chflags(1), chflags(2), malloc(3)

     The fflagstostr() and strtofflags() functions first appeared in
     FreeBSD 4.0.

BSD                             January 1, 2000                            BSD