Mac Developer Library Developer
Search

 

This manual page is part of Xcode Tools version 5.0

To obtain these tools:

If you are running a version of Xcode Tools other than 5.0, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.




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

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

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <unistd.h>

     char *
     fflagstostr(unsigned long flags);

     int
     strtofflags(char **stringp, unsigned long *setp, unsigned long *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() 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 suc-cess success
     cess strtofflags() returns 0, otherwise it returns non-zero and stringp is left pointing to the offend-ing offending
     ing token.

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

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

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

BSD                             January 1, 2000                            BSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Feedback