Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pipe(2)			      System Calls Manual		       pipe(2)

NAME
       pipe - create an	interprocess channel

SYNOPSIS
DESCRIPTION
       creates	an  I/O	 mechanism called a pipe and returns two file descrip-
       tors, fildes[0] and fildes[1].  fildes[0] is  opened  for  reading  and
       fildes[1] is opened for writing.

       A  read-only  file  descriptor  fildes[0]  accesses the data written to
       fildes[1] on a first-in-first-out (FIFO)	basis.	For details of the I/O
       behavior	of pipes see read(2) and write(2).

       By  default, HP-UX pipes	are not	STREAMS-based.	It is possible to gen-
       erate the kernel	so that	all pipes created on  a	 system	 are  STREAMS-
       based.	This  can  only	 be  done  for	HP-UX releases 10.0 and	later.
       STREAMS-based FIFOs (created by or are not supported on HP-UX.

       To generate a kernel that supports STREAMS-based	pipes:

       o  STREAMS/UX must be installed.

       o  The module and the driver must  be  included	in  the	 file.	 (When
	  STREAMS/UX  is  installed, and are automatically added to the	system
	  file.)

       o  The tunable parameter	"streampipes" must be set to 1	in  the	 file.
	  (This	is not automatically done when STREAMS/UX is installed.)

       o  The  kernel must be generated	and the	system rebooted.  Once this is
	  done,	all pipes created by will be STREAMS-based.

       For more	information, see

EXAMPLES
       The following example uses to implement the command string

RETURN VALUE
       Upon successful completion, a value of is returned.  Otherwise, a value
       of -1 is	returned and is	set to indicate	the error.

ERRORS
       fails if	one or more of the following is	true:

       [EMFILE]	      -1 or more file descriptors are currently	open.

       [ENFILE]	      The system file table is full.

       [ENOSPC]	      The  file	 system	 lacks	sufficient space to create the
		      pipe.

       [ENOSR]	      Could not	 allocate  resources  for  both	 Stream	 heads
		      (STREAMS-based pipes only).

SEE ALSO
       sh(1), read(2), write(2), popen(3S), streamio(7).

STANDARDS CONFORMANCE
								       pipe(2)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | RETURN VALUE | ERRORS | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pipe&sektion=2&manpath=HP-UX+11.22>

home | help