Next: bpipe_read_dpkts, Previous: bpipe_new, Up: BPipe Manipulations
create a binary pipe output channel
#include <bpipe/bpipe.h>BPipeOutput *bpipe_output( BPipe *bpipe, char *path );
BPipe *bpipe
- a pointer to the binary pipe structure
char *path
- the path to the channel to attach to this output descriptor
bpipe_output
attaches an output stream and opens it.
The parameter output
is a string describing the output file or
device associated with the output channel. If it is the string
‘stdout’, the output channel is associated with the standard
output stream.
It returns an output handle upon success, NULL
upon failure.
Upon error bpipe_errno
is set to one of the following errors:
BPEBADARG
errno
for more
information.
BPEBADPIPE
BPipe
's header has already been mapped or written. Output
channels can only be opened before mapping or writing the header
BPENOMEM