fdetach(3C)                      UNIX System V                      fdetach(3C)


NAME
      fdetach - detach a name from a STREAMS-based file descriptor

SYNOPSIS
      int fdetach(const char *path);

DESCRIPTION
      The fdetach routine detaches a STREAMS-based file descriptor from a name
      in the file system.  path is the path name of the object in the file
      system name space, which was previously attached [see fattach(3C)]. The
      user must be the owner of the file or a user with the appropriate
      privileges.  All subsequent operations on path will operate on the file
      system node and not on the STREAMS file.  The permissions and status of
      the node are restored to the state the node was in before the STREAMS
      file was attached to it.

RETURN VALUE
      If successful, fdetach returns 0; otherwise it returns -1 and sets errno
      to indicate an error.

ERRORS
      Under the following conditions, the function fdetach fails and sets errno
      to:

      EPERM        The effective user ID is not the owner of path or is not a
                   user with appropriate permissions.

      ENOTDIR      A component of the path prefix is not a directory.

      ENOENT       path does not exist.

      EINVAL       path is not attached to a STREAMS file.

      ENAMETOOLONG The size of path exceeds {PATHMAX}, or a path name
                   component is longer than {NAMEMAX} while {POSIXNOTRUNC}
                   is in effect.

      ELOOP        Too many symbolic links were encountered in translating
                   path.

SEE ALSO
      fdetach(1M), fattach(3C), streamio(7)
      in the Programmer's Guide: STREAMS











10/89                                                                    Page 1