fdetach man page on DigitalUNIX

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

fdetach(3)							    fdetach(3)

       fdetach	-  Detach  a  STREAMS-based file descriptor from a file in the
       file system name space

       #include <stropts.h>

       int fdetach(
	       const char *path );

       Standard C Library (libc.so, libc.a)

       Interfaces documented on this reference page conform to industry	 stan‐
       dards as follows:

       fdetach():  XSH4.0, XSH4.2, XSH5.0

       Refer to standards(5) for more information about industry standards and
       associated tags.

       Specifies the pathname of an existing regular file or directory.

       The fdetach() function disassociates a  STREAMS-based  file  descriptor
       from  the file pointed to by the path parameter. The STREAMS-based file
       descriptor was associated with the file by a prior fattach() function.

       A successful call to the fdetach() function causes all path names  that
       named  the  attached  STREAMS  file to again name the file to which the
       STREAMS file was attached.   All	 subsequent  operations	 on  the  file
       pointed	to  by the path parameter are performed on the underlying file
       and not on the STREAMS file.

       All open file  descriptors  established	while  the  STREAMS  file  was
       attached	 to  the  file referenced by the path parameter still refer to
       the STREAMS file after the fdetach() function takes effect.

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

       The detach() function uses the File-on-File Mounting (FFM) file system.
       Instead	of  unmounting	a  file	 system on a mount point, the detach()
       function FFM unmounts a file descriptor from a mount point,  which  can
       be either a directory or a regular file.	 See ffm(4).

       [Tru64  UNIX]  The  fdetach()  function requires that the FFM_FS kernel
       option be configured.  See System  Administration  for  information  on
       configuring kernel options.

       Upon successful completion, the fdetach() function returns a value of 0
       (zero). Otherwise, it returns a value of -1 is returned, and  errno  is
       set to indicate the error.

       If  any of the following conditions occurs, the fdetach() function sets
       errno to the value that corresponds to the condition.  The user is  not
       the  owner  of  the  file  or  does not have the correct permissions to
       access the file.	 [Tru64 UNIX]  There is an active reference to a  file
       located	on  the	 file system.  [Tru64 UNIX]  The path parameter points
       outside the process's allocated	address	 space.	  The  path  parameter
       names  a	 file that is not currently attached.  Too many symbolic links
       were found when path was resolved.  An element of  the  path  parameter
       does  not name an existing file or path is an empty string.  An element
       of the directory portion of the path  parameter	is  not	 a  directory.
       [Tru64  UNIX]  The size of a pathname component is longer than NAME_MAX
       when _POSIX_NO_TRUNC is in effect.

	      The pathname length is longer than [PATH_MAX], or the length  of
	      the  intermediate	 result of a pathname resolution of a symbolic
	      link is longer than PATH_MAX.  The effective user ID is not  the
	      owner  of	 the file pointed to by the path parameter or does not
	      specify a user with the correct privileges.

       Functions: fattach(3), isastream(3), umount(3)

       Commands: fdetach(8)

       Interfaces: streamio(7)

       Standards: standards(5)

       Network Programmer's Guide


List of man pages available for DigitalUNIX

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]
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