NAME
	  sigvec - Provides a compatibility interface to the sigac-
	  tion() function

     SYNOPSIS
	  #include <sys/signal.h>
	  int sigvec (
	       int signal,
	       struct sigvec *in_vec,
	       struct sigvec *out_vec );

     PARAMETERS
	  signal
	       Specifies the signal number.

	  in_vec
	       Points to a sigvec() structure that specifies the
	       action to be taken when the specified signal is
	       delivered, the mask to be used when calling the signal
	       handler,	and the	flags that modify signal behavior.

	  out_vec
	       Points to a sigvec() structure that is set to the pre-
	       vious signal action state on successful return from the
	       sigvec()	function.

     DESCRIPTION
	  The sigvec() function	is provided for	compatibility to old
	  UNIX systems;	 its function is a subset of that available
	  with the sigaction() function. Like the sigaction() func-
	  tion,	the sigvec() function allows the user to set the
	  action to take upon the receipt of a signal and to specify a
	  signal handler mask to block signals before calling the sig-
	  nal handler. However,	only signals with values 1 to 31 can
	  be masked on entry to	a signal-handler set up	with the
	  sigvec() function.

	  The sigvec() structure has the following members:

	    void (*sv_handler)(	);
	    int	 sv_mask;
	    int	 sv_flags;

	  The sv_handler field specifies the action for	the signal,
	  and can be SIG_DFL, SIG_IGN, or the address of a signal
	  handler function. See	the sigaction()	function for a
	  detailed description of the signal actions.

	  The sv_mask field specifies a	mask which specifies signals
	  to block (in addition	to any signals already blocked at time
	  of delivery) when the	signal handler function	is called for
	  the signal. Signal i is blocked if the i-th bit of the mask
	  is set. Only signals with values 1 to	31 can be masked with
	  the sigvec() function.  The sv_flags field contains flags
	  that further specify signal behavior.	 If SV_ONSTACK is set,
	  the signal handler runs on the signal	stack specified	by the
	  sigstack() function;	otherwise, the signal handler runs on
	  the stack of the process receiving the signal.  If
	  SV_INTERRUPT is set, a system	call that is interrupted by
	  signal returns a value of -1 with errno set to [EINTR];
	  otherwise, a system call interrupted by signal is restarted.

	  If the value of the in_vec parameter is a null pointer, then
	  the signal handler information is not	set. If	the value of
	  the out_vec parameter	is null, then the previous signal
	  handler information is not returned.

	  Once a signal	handler	is assigned, it	remains	assigned until
	  another call to the sigvec(),	signal(), sigaction(), or exec
	  function is made.

     NOTES
	  The sigvec() function	is provided for	compatibility only,
	  and its use is not recommended.   Programs should use	the
	  sigaction() function instead.

	  The sigvec() function	does not check the validity of the
	  sv_handler field pointer. If it points to a location outside
	  of the process address space,	the process receives a memory
	  fault	when the system	attempts to call the signal handler.
	  If the sv_handler field points to anything other than	a
	  function, the	results	are unpredictable.

	  The signal-handler function can be declared as follows:

	  void handler (
	       int signal );

     RETURN VALUES
	  Upon successful completion, a	value of 0 (zero) is returned.
	  If the sigvec() function fails, a value of -1	is returned
	  and errno is set to indicate the error.

     ERRORS
	  If the sigvec() function fails, no new signal	handler	is
	  installed and	errno may be set to one	of the following
	  values:

	  [EFAULT]  The	in_vec or out_vec parameter points to a	loca-
		    tion outside of the	process' address space.

	  [EINVAL]  The	signal parameter is not	a valid	signal number.

	  [EINVAL]  An attempt was made	to ignore or supply a handler
		    for	the SIGKILL signal.

     RELATED INFORMATION
	  Functions: kill(2), ptrace(2), sigaction(2), sigblock(2),
	  sigpause(3), sigstack(2)















































Acknowledgement and Disclaimer