fflagstostr(3STDC)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | ERRORS | SEE ALSO

NAME

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

SYNOPSIS

$(OS_DIR)/lib/libc.a
#include <unistd.h>

char * fflagstostr(u_long flags);
int strtofflags(char ** stringp, u_long * setp, u_long * clrp);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

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(3STDC) and should be returned to the system with free(3STDC) when the program is done with it.

The strtofflags() function takes a string of file flags, parses it, and returns the 'set' flags and 'clear' flags. 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(3STDC) .

SEE ALSO

malloc(3STDC)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | ERRORS | SEE ALSO