From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <glibc-bugs-return-22636-listarch-glibc-bugs=sources.redhat.com@sourceware.org>
Received: (qmail 27231 invoked by alias); 2 Jun 2014 12:23:21 -0000
Mailing-List: contact glibc-bugs-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <glibc-bugs.sourceware.org>
List-Subscribe: <mailto:glibc-bugs-subscribe@sourceware.org>
List-Post: <mailto:glibc-bugs@sourceware.org>
List-Help: <mailto:glibc-bugs-help@sourceware.org>, <http://sourceware.org/lists.html#faqs>
Sender: glibc-bugs-owner@sourceware.org
Received: (qmail 27192 invoked by uid 48); 2 Jun 2014 12:23:15 -0000
From: "GavinSmith0123 at gmail dot com" <sourceware-bugzilla@sourceware.org>
To: glibc-bugs@sourceware.org
Subject: [Bug manual/17011] New: Example in "Allocating Pseudo-Terminals" section uses isastream
Date: Mon, 02 Jun 2014 12:23:00 -0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: new
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: glibc
X-Bugzilla-Component: manual
X-Bugzilla-Version: unspecified
X-Bugzilla-Keywords:
X-Bugzilla-Severity: normal
X-Bugzilla-Who: GavinSmith0123 at gmail dot com
X-Bugzilla-Status: NEW
X-Bugzilla-Priority: P2
X-Bugzilla-Assigned-To: unassigned at sourceware dot org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags:
X-Bugzilla-Changed-Fields: bug_id short_desc product version bug_status bug_severity priority component assigned_to reporter cc
Message-ID: <bug-17011-131@http.sourceware.org/bugzilla/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit
X-Bugzilla-URL: http://sourceware.org/bugzilla/
Auto-Submitted: auto-generated
MIME-Version: 1.0
X-SW-Source: 2014-06/txt/msg00012.txt.bz2

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.