docs/74889: S_ISREG etc marcos missing from stat man page

[Alden]

>Number:         74889
>Category:       docs
>Synopsis:       S_ISREG etc marcos missing from stat man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Dec 09 12:20:20 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Alden
>Release:        Man pages on freebsd.org website
>Organization:
Plasmon
>Environment:
NA
>Description:
      The section 2 man page for stat, lstat, etc does not define the POSIX macros to define file mode - i.e. S_ISLNK, S_ISREG, etc. The macros do not appear to have their own man page.

As the macros exist only for testing the st_mode field in the stat buffer the stat man page is the obvious place to define them.

I know the macros exist because I'm using them.
>How-To-Repeat:
      Using the man page interface on www.freebsd.org, search for lstat. Look in all sections. I've tried FreeBSD 6.0-current and FreeBSD 4.8-RELEASE (which is the BSD version I'm using).

The S_IFLNK flag is defined, but not the macro to test it. Same for the other file modes.
>Fix:
      Include the standard definition for the macros. Text from the linux man page for stat below, as an example:

   The following POSIX macros are defined to check the file type:

              S_ISREG(m)  is it a regular file?

              S_ISDIR(m)  directory?

              S_ISCHR(m)  character device?

              S_ISBLK(m)  block device?

              S_ISFIFO(m) fifo?

              S_ISLNK(m)  symbolic link? (Not in POSIX.1-1996.)

              S_ISSOCK(m) socket? (Not in POSIX.1-1996.)

>Release-Note:
>Audit-Trail:
>Unformatted: