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

NAME
     ffffllaaggssttoossttrr, ssttrrttooffffllaaggss - convert between file flag bits and their
     string names

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     char *
     ffffllaaggssttoossttrr(ulong flags);

     int
     ssttrrttooffffllaaggss(char **stringp, ulong *setp, ulong *clrp);

DESCRIPTION
     The ffffllaaggssttoossttrr() 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, ffffllaaggssttoossttrr() returns
     NULL.

     The value returned from ffffllaaggssttoossttrr() is obtained from mmaalllloocc() and
     should be returned to the system with ffrreeee() when the program is done
     with it.

     The ssttrrttooffffllaaggss() 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 ssttrrttooffffllaaggss()
     returns 0, otherwise it returns non-zero and stringp is left pointing to
     the offending token.

EERRRROORRSS
     The ffffllaaggssttoossttrr() 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 ffffllaaggssttoossttrr() and ssttrrttooffffllaaggss() functions first appeared in
     FreeBSD 4.0.

BSD                             January 1, 2000                            BSD