This is the mail archive of the glibc-bugs@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[Bug manual/17011] New: Example in "Allocating Pseudo-Terminals" section uses isastream


https://sourceware.org/bugzilla/show_bug.cgi?id=17011

            Bug ID: 17011
           Summary: Example in "Allocating Pseudo-Terminals" section uses
                    isastream
           Product: glibc
           Version: unspecified
            Status: NEW
          Severity: normal
          Priority: P2
         Component: manual
          Assignee: unassigned at sourceware dot org
          Reporter: GavinSmith0123 at gmail dot com
                CC: mtk.manpages at gmail dot com, roland at gnu dot org

There is an example function showing use of the functions for opening a
pseudo-terminal pair in the "Allocating Pseudo-Terminals" section of the
manual. There is a conditional block using the "isastream" function which calls
extra ioctls on the slave file descriptor.

However, when I tried to use this example, I got error messages that there was
no function isastream, and there is no mention of isastream anywhere else in
the manual.

I assume it is related to the comment above the code about a file being
"STREAMS-based" on System V-derived systems (based on the common use of the
word "stream"), but there's no explanation of what this means or any references
to an explanation. If this is the case, I would suggest placing a comment in
the example function above the condition which said something like "Only do
this on a System V system".

-- 
You are receiving this mail because:
You are on the CC list for the bug.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]