| STRTOFFLAGS(3) | Library Functions Manual | STRTOFFLAGS(3) |
fflagstostr,
strtofflags — convert
between file flag bits and their string names
#include
<unistd.h>
char *
fflagstostr(u_int32_t
flags);
int
strtofflags(char
**stringp, u_int32_t
*setp, u_int32_t
*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
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() 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).
The fflagstostr() and
strtofflags() functions first appeared in
OpenBSD 2.8.
| June 5, 2013 | Debian |