Skip to contentSkip to conversation

system_data_types.7: Add 'fd_set'

PATCH In review Alejandro Colomar 2 participants 4 messages Oct 8, 2020 – Oct 10, 2020 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 system_data_types.7: Add 'fd_set'

---

Hi Michael,

There's no link for this type, because it would conflict with FD_SET.3, which is a link to select(2).

Cheers,

Alex

 man7/system_data_types.7 | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
man7/system_data_types.7 +17 -0
index b0e0d2b48..adddf823f 100644
@@ -151,6 +151,23 @@ See also the
 .I float_t
 type in this page.
 .RE
+.\"------------------------------------- fd_set -----------------------/
+.TP
+.I fd_set
+.RS
+Include:
+.IR <sys/select.h> .
+Alternatively,
+.IR <sys/time.h> .
+.PP
+A structure holding a fixed size buffer of file descriptors.
+.PP
+Conforming to:
+POSIX.1-2001 and later.
+.PP
+See also:
+.BR select (2)
+.RE
 .\"------------------------------------- fenv_t -----------------------/
 .TP
 .I fenv_t
Signature · 1 line
2.28.0
#1 lore raw

Hi Alex,

Thanks for the patch. See below.

Quoted 8 lines · Alejandro Colomar

---

Hi Michael,

There's no link for this type, because it would conflict with FD_SET.3, which is a link to select(2).

Okay.

Quoted 11 lines
 man7/system_data_types.7 | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
man7/system_data_types.7 +0 -0
index b0e0d2b48..adddf823f 100644
@@ -151,6 +151,23 @@ See also the
 .I float_t
 type in this page.
 .RE

man7/system_data_types.7 See also the · line 163

Quoted 10 lines
man7/system_data_types.7 +10 -0
+.\"------------------------------------- fd_set -----------------------/
+.TP
+.I fd_set
+.RS
+Include:
+.IR <sys/select.h> .
+Alternatively,
+.IR <sys/time.h> .
+.PP
+A structure holding a fixed size buffer of file descriptors.

"buffer" feels wrong.

I think this would be better as something like:

"A structured type that can represent a set of file descriptors."

And then you could perhaps say somewhere: "In the glibc implementation, the maximum file descriptor number that can be represented is 1023."

Thanks

Michael

#2 lore raw

PATCH 1/1 system_data_types.7: Add 'fd_set'

---

Hi Michael,

I found that POSIX defines the limit in a macro, so I used that.

Thanks,

Alex

 man7/system_data_types.7 | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
man7/system_data_types.7 +22 -0
index b0e0d2b48..a4a2e0ab8 100644
@@ -151,6 +151,28 @@ See also the
 .I float_t
 type in this page.
 .RE
+.\"------------------------------------- fd_set -----------------------/
+.TP
+.I fd_set
+.RS
+Include:
+.IR <sys/select.h> .
+Alternatively,
+.IR <sys/time.h> .
+.PP
+A structure type that can represent a set of file descriptors.
+According to POSIX,
+the maximum number of file descriptors in an
+.I fd_set
+structure is the value of the macro
+.BR FD_SETSIZE .
+.PP
+Conforming to:
+POSIX.1-2001 and later.
+.PP
+See also:
+.BR select (2)
+.RE
 .\"------------------------------------- fenv_t -----------------------/
 .TP
 .I fenv_t
Signature · 1 line
2.28.0
#3 lore raw
Quoted 10 lines · Alejandro Colomar

---

Hi Michael,

I found that POSIX defines the limit in a macro, so I used that.

Thanks,

Alex

Thanks, Alex. Patch applied.

Cheers,

Michael

Quoted 37 lines
 man7/system_data_types.7 | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
man7/system_data_types.7 +22 -0
index b0e0d2b48..a4a2e0ab8 100644
@@ -151,6 +151,28 @@ See also the
 .I float_t
 type in this page.
 .RE
+.\"------------------------------------- fd_set -----------------------/
+.TP
+.I fd_set
+.RS
+Include:
+.IR <sys/select.h> .
+Alternatively,
+.IR <sys/time.h> .
+.PP
+A structure type that can represent a set of file descriptors.
+According to POSIX,
+the maximum number of file descriptors in an
+.I fd_set
+structure is the value of the macro
+.BR FD_SETSIZE .
+.PP
+Conforming to:
+POSIX.1-2001 and later.
+.PP
+See also:
+.BR select (2)
+.RE
 .\"------------------------------------- fenv_t -----------------------/
 .TP
 .I fenv_t
Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/