From owner-freebsd-doc@FreeBSD.ORG Thu Dec 9 12:20:21 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3590E16A4CE for ; Thu, 9 Dec 2004 12:20:21 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id EE83943D62 for ; Thu, 9 Dec 2004 12:20:20 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id iB9CKKov053694 for ; Thu, 9 Dec 2004 12:20:20 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.1/8.13.1/Submit) id iB9CKKWJ053693; Thu, 9 Dec 2004 12:20:20 GMT (envelope-from gnats) Resent-Date: Thu, 9 Dec 2004 12:20:20 GMT Resent-Message-Id: <200412091220.iB9CKKWJ053693@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Alden Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6904416A4CE for ; Thu, 9 Dec 2004 12:13:59 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5548343D5A for ; Thu, 9 Dec 2004 12:13:59 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.13.1/8.13.1) with ESMTP id iB9CDxjE046699 for ; Thu, 9 Dec 2004 12:13:59 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id iB9CDwTS046697; Thu, 9 Dec 2004 12:13:59 GMT (envelope-from nobody) Message-Id: <200412091213.iB9CDwTS046697@www.freebsd.org> Date: Thu, 9 Dec 2004 12:13:59 GMT From: Alden To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Subject: docs/74889: S_ISREG etc marcos missing from stat man page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 09 Dec 2004 12:20:21 -0000 >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: