fdetach man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

fdetach(3C)		 Standard C Library Functions		   fdetach(3C)

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

SYNOPSIS
       #include <stropts.h>

       int fdetach(const char *path);

DESCRIPTION
       The  fdetach()  function detaches a STREAMS-based file from the file to
       which it was attached by a previous call to fattach(3C). The path argu‐
       ment  points  to the pathname of the attached STREAMS file. The process
       must have appropriate privileges or be the owner of the	file.  A  suc‐
       cessful	call to fdetach() causes all pathnames that named the attached
       STREAMS file to again name the file  to	which  the  STREAMS  file  was
       attached.  All subsequent operations on path will operate on the under‐
       lying file and not on the STREAMS file.

       All open file descriptions  established	while  the  STREAMS  file  was
       attached	 to  the  file	referenced  by	path,  will still refer to the
       STREAMS file after the fdetach() has taken effect.

       If there are no open  file  descriptors	or  other  references  to  the
       STREAMS	file,  then a successful call to fdetach() has the same effect
       as performing the last close(2) on the attached file.

RETURN VALUES
       Upon successful completion, fdetach() returns 0. Otherwise, it  returns
       −1 and sets errno to indicate the error.

ERRORS
       The fdetach() function will fail if:

       EACCES		       Search  permission  is denied on a component of
			       the path prefix.

       EPERM		       The effective user ID is not the owner of  path
			       and the process does not have appropriate priv‐
			       ileges.

       ENOTDIR		       A component of the path prefix is not a	direc‐
			       tory.

       ENOENT		       A  component  of path does not name an existing
			       file or path is an empty string.

       EINVAL		       The path argument names a file that is not cur‐
			       rently attached.

       ENAMETOOLONG	       The  size  of a pathname exceeds PATH_MAX, or a
			       pathname	 component  is	longer	than  NAME_MAX
			       while _POSIX_NO_TRUNC is in effect.

       ELOOP		       Too  many  symbolic  links  were encountered in
			       resolving path.

       The fdetach() function may fail if:

       ENAMETOOLONG	       Pathname resolution of a symbolic link produced
			       an  intermediate	 result	 whose	length exceeds
			       PATH_MAX.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Standard			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       fdetach(1M),  close(2),	 fattach(3C),	attributes(5),	 standards(5),
       streamio(7I)

       STREAMS Programming Guide

SunOS 5.10			  24 Jul 2002			   fdetach(3C)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net