sigvec man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

sigvec(2)							     sigvec(2)

NAME
       sigvec - Provide a compatibility interface to the sigaction() function

SYNOPSIS
       #include <sys/signal.h>

       int sigvec(
	       int signal,
	       struct sigvec *in_vec,
	       struct sigvec *out_vec );

PARAMETERS
       Specifies  the signal number.  Points to a sigvec structure that speci‐
       fies 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.	Points to a sigvec structure that  is  set  to
       the previous signal action state on successful return from the sigvec()
       function.

DESCRIPTION
       The sigvec() function is provided for compatibility with old UNIX  sys‐
       tems;  its  function  is	 a subset of the operations available with the
       sigaction() function. Like the sigaction() function, the sigvec() func‐
       tion  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 signal 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 sigvec() is made or a call is made to signal(), sigaction()  or
       one of the exec functions.

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: The in_vec or  out_vec
       parameter  points  to a location outside of the process' address space.
       The signal parameter is not a valid signal number  or  an  attempt  was
       made to ignore or supply a handler for the SIGKILL signal.

SEE ALSO
       Functions:  kill(2), ptrace(2), sigaction(2), sigblock(2), sigpause(3),
       sigstack(2)

								     sigvec(2)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net