Bug 436407

Summary: man pages imply STREAMS is implemented
Product: [Fedora] Fedora Reporter: Jeff Bastian <jbastian>
Component: man-pagesAssignee: Ivana Varekova <varekova>
Status: CLOSED RAWHIDE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: low Docs Contact:
Priority: low    
Version: 8   
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2008-03-07 11:27:22 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Jeff Bastian 2008-03-06 23:14:41 UTC
+++ This bug was initially created as a clone of Bug #436398 +++

As far as I can tell, Linux does not include a STREAMS implementation.  Looking
at the glibc source code, most of the STREAMS functions are empty stubs like
streams/isastream.c:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
int
isastream (fildes)
     int fildes;
{
  /* In general we do not have a STREAMS implementation and therefore
     return 0.  But for invalid file descriptors we have to return an
     error.  */
  if (__fcntl (fildes, F_GETFD) < 0)
    return -1;

  /* No STREAM.  */
  return 0;
}
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


But these man pages would imply that STREAMS is available in Fedora 8:
  fattach(3p)
  fdetach(3p)
  getmsg(3p)
  isastream(3p)
  putmsg(3p)

Other man pages include notes on STREAMS, for example, open(3p), close(3p),
read(3p), write(3p), but these are implemented for other non-STREAMS usage.

At least two STREAMS man pages, getpmsg(2) and putpmsg(2), bring up the
unimplemented(2) man page and indicate they are "Unimplemented system calls."

Please remove or link the other man pages to unimplemented(2).

Comment 1 Ivana Varekova 2008-03-07 11:27:22 UTC
Fixed in man-pages-2.78-2.fc9.