MirBSD manpage: fflagstostr(3), strtofflags(3)

STRTOFFLAGS(3)             BSD Programmer's Manual              STRTOFFLAGS(3)

NAME

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

SYNOPSIS

     #include <unistd.h>

     char *
     fflagstostr(u_int32_t flags);

     int
     strtofflags(char **stringp, u_int32_t *setp, u_int32_t *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(3) and
     should be returned to the system with free(3) 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" and "clear" flags such as
     would be given as arguments to chflags(2). On success, strtofflags() re-
     turns 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
     OpenBSD 2.8.

MirBSD #10-current             January 1, 2000                               1