Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

fattach(3C)							   fattach(3C)

NAME
       fattach()  -  attach a STREAMS file descriptor to an object in the file
       system name space

SYNOPSIS
DESCRIPTION
       The function attaches the fd file descriptor to an object in  the  file
       system  name  space  designated	by  path.   fd	specifies an open file
       descriptor to a STREAMS device or STREAMS-based pipe.   path  specifies
       the  pathname  of  an  existing	object	in the file system.  A STREAMS
       device or pipe can be attached to more than one node in the file system
       name space. In other words, a STREAMS device or pipe is allowed to have
       several associated names.  Until the STREAMS device or pipe is detached
       from the node (with fdetach(3C) or fdetach(1M)), all operations on path
       will act on the STREAMS device or  pipe	instead	 of  the  file	system
       object path.

       The  stream's  attributes  (see	the  stat(2)  reference	 page) are set
       according to the following scheme:

       ·  The group ID, user ID, times, and permissions are set	 to  those  of
	  path.

       ·  The  size  as	 well  as  the	device	number are set to those of the
	  STREAMS device or pipe designated by the fd  parameter.   Note  that
	  although  the	 attributes  of	 the STREAMS device or pipe may change
	  (see the chmod(2) reference page), the attributes of the  underlying
	  file system object path will not be changed.

       ·  The number of links is set to 1.

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

ERRORS
       If any of the following conditions occurs, the  function	 sets  to  the
       value that corresponds to the condition.

       [EACCES]		     Although  the user is the owner of path, the user
			     has no write permissions for it.

       [EBADF]		     The fd parameter is an invalid file descriptor.

       [EBUSY]		     The existing object specified by the path parame‐
			     ter  is  already mounted or has a file descriptor
			     attached to it.

       [EFAULT]		     The path parameter points to a  location  outside
			     of the allocated address space of the process.

       [EINVAL]		     The  fd  parameter	 does  not  refer to a STREAMS
			     device or STREAMS-based pipe.

       [ELOOP]		     When path was translated, too many symbolic links
			     were found.

       [ENOENT]		     path does not exist.

       [ENOTDIR]	     The  directory portion of the path parameter does
			     not exist.

       [ENAMETOOLONG]	     The size of a pathname component is  longer  than
			     when  is  in  effect,  or	the pathname length is
			     longer than

       [EPERM]		     The current effective user ID is not the owner of
			     the existing object specified by the path parame‐
			     ter.

SEE ALSO
       fdetach(3C),    isastream(3C),	 chmod(2),    stat(2),	  fdetach(1M),
       streamio(7).

STANDARDS COMPLIANCE
								   fattach(3C)

Vote for polarhome