start_xshow

[ XITE Reference Manual | XITE home ]

Name

start_xshow - start xshow

Syntax

 #include <xite/fork_xshow.h>

 pid_t start_xshow( int *pipe_io );

Description

Start xshow in the background. Upon return, pipe_io[1] will contain the file descriptor to use to send images to xshow. Send images with Iwrite_image and filename "-n", where n equals pipe_io[1]. Remember to close pipe_io[1] when you don't need it anymore.

xshow will read from the filedescriptor in pipe_io[0]. This filedescriptor is not open to the parent (calling) process.

Diagnostics

Error messages will be issued if the pipe could not be created, if the child process could not be created, or if xshow could not be executed.

Return value

 >0: Process ID for child process (xshow).
 -2: Failed in creating pipes.
 -1: Failed in creating child process.

See also

xshow(1), fork_xshow(1), Iwrite_image(5)

Author

Svein Bøe, BLAB, Ifi, UiO

Id

$Id: fork_xshow.c,v 1.4 1997/06/11 09:47:26 svein Exp $