fdetach(1M)                                                     fdetach(1M)




 NAME    [Toc]    [Back]
      fdetach - detach a STREAMS-based file descriptor from a filename

 SYNOPSIS    [Toc]    [Back]
      fdetach path

 DESCRIPTION    [Toc]    [Back]
      The fdetach command detaches or disassociates a file descriptor for an
      open STREAMS device or pipe from its filename in the file system.  The
      path argument is the path that was previously associated with the file
      descriptor by the fattach() function.

      Operations on path will subsequently affect the file system node, not
      the STREAMS device or pipe.  The permissions and status of the node
      are returned to the state that they were in before the STREAMS device
      or pipe was attached. Any other paths that the STREAMS device or pipe
      may be attached to are not affected.

      To successfully issue the fdetach command, the user must be superuser
      or must be the owner of the file and have write permission.

 RETURN VALUE    [Toc]    [Back]
      fdetach returns 0 (zero) on success.  If fdetach fails, it returns 1
      and prints a message to stderr.

 EXAMPLES    [Toc]    [Back]
      To detach the file descriptor for the STREAMS file /tmp/streamfile
      from its associated file system node, enter:

      fdetach /tmp/streamfile

 FILES    [Toc]    [Back]
      /usr/lib/nls/C/fdetach.cat              NLS catalog for fdetach.

 SEE ALSO    [Toc]    [Back]
      fattach(3C), fdetach(3C), streamio(7).


 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003