Project

General

Profile

Bug #1192

fd manpage should be in section 7

Added by Yuri Pankov over 9 years ago. Updated over 9 years ago.

Status:
Resolved
Priority:
Low
Assignee:
-
Category:
manpage - manual pages
Start date:
2011-07-08
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:
Gerrit CR:

Description

fd manpage is describing special files in /dev and should live in section 7. While here, add links for stdin, stdout and stderr to fd.

#1

Updated by Rich Lowe over 9 years ago

I think the idea is that its describing files and thus in 4. We mostly use 7 itself for non-driver kernel modules it seems. I think that it doesn't really fit that well anywhere, but either 7FS or just leaving it in 4 seems reasonable?

#2

Updated by Yuri Pankov over 9 years ago

Well, my understanding is that 4 is 'file formats', fd doesn't describe any format, it talks about special files in /dev; if it doesn't fit in any subsection of 7 then let it just be in 7 itself (if we didn't use 7 for this, we can always start doing it if it seems logical).

#3

Updated by Albert Lee over 9 years ago

I cite zero(7D) and null(7D) as supporting evidence this should be in section 7D.
intro(7) doesn't describe anything other than subsections.

     (7D)     The  system  provides  drivers  for  a  variety  of
              hardware  devices,  such  as  disk, magnetic tapes,
              serial  communication  lines,   mice,   and   frame
              buffers,   as  well  as  virtual  devices  such  as
              pseudo-terminals and windows.

              This section describes special files that refer  to
              specific  hardware  peripherals and device drivers.
              STREAMS    device  drivers  are   also   described.
              Characteristics of both the hardware device and the
              corresponding device  driver  are  discussed  where
              applicable.

Anything in (7) right now appears to either be X server drivers or leftover stuff from the BSD manpage section.

#4

Updated by Yuri Pankov over 9 years ago

Last attempt at being stubborn :-)

Albert Lee wrote:

I cite zero(7D) and null(7D) as supporting evidence this should be in section 7D.

intro(7) also reads "All device special files are located under the /devices directory.", /dev/zero and /dev/null are indeed links to /devices/, while /dev/fd/ contents aren't.

intro(7) doesn't describe anything other than subsections.

We could fix that :-)

[...]
Anything in (7) right now appears to either be X server drivers or leftover stuff from the BSD manpage section.

It also could be used for special cases like fd.

#5

Updated by Garrett D'Amore over 9 years ago

  • Status changed from New to Resolved
  • % Done changed from 0 to 100

Resolved in:

changeset: 13424:f2dd4a8a49cd
tag: tip
user: Yuri Pankov <>
date: Wed Aug 10 22:43:54 2011 -0700
description:
635 sed manual page needs significant updates
1188 Move pppdump and tcpd manpages to usr/src/man
1189 add stdin/stdout/stderr(3C) manpage symlinks
1190 Remove source-security-tcp-wrapper and SUNWtcpdS packages
1191 Remove source-network-pppdump and SUNWpppgS packages
1192 fd manpage should be in section 7
Reviewed by: Albert Lee <>
Reviewed by: Gordon Ross <>
Approved by: Garrett D'Amore <>

Also available in: Atom PDF