home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / ixemul-39.47-env-bin.lha / man / cat2 / sigstack.0 < prev    next >
Encoding:
Text File  |  1993-12-07  |  2.2 KB  |  67 lines
  1.  
  2. SIGSTACK(2)                UNIX Programmer's Manual                SIGSTACK(2)
  3.  
  4. NNAAMMEE
  5.      ssiiggssttaacckk - set and/or get signal stack context
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ssiiggnnaall..hh>>
  9.      struct sigstack {
  10.              caddr_t ss_sp;
  11.              int     ss_onstack;
  12.      };
  13.  
  14.      _i_n_t
  15.      ssiiggssttaacckk(_c_o_n_s_t _s_t_r_u_c_t _s_i_g_s_t_a_c_k _*_s_s, _s_t_r_u_c_t _s_i_g_s_t_a_c_k _*_o_s_s)
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      SSiiggssttaacckk() allows users to define an alternate stack on which signals are
  19.      to be processed.  If _s_s is non­zero, it specifies a _s_i_g_n_a_l _s_t_a_c_k on which
  20.      to deliver signals and tells the system if the process is currently exe­
  21.      cuting on that stack.  When a signal's action indicates its handler
  22.      should execute on the signal stack (specified with a sigvec(2) call), the
  23.      system checks to see if the process is currently executing on that stack.
  24.      If the process is not currently executing on the signal stack, the system
  25.      arranges a switch to the signal stack for the duration of the signal han­
  26.      dler's execution.  If _o_s_s is non­zero, the current signal stack state is
  27.      returned.
  28.  
  29. NNOOTTEESS
  30.      Signal stacks are not ``grown'' automatically, as is done for the normal
  31.      stack.  If the stack overflows unpredictable results may occur.
  32.  
  33. RREETTUURRNN VVAALLUUEESS
  34.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  35.      of ­1 is returned and _e_r_r_n_o is set to indicate the error.
  36.  
  37. EERRRROORRSS
  38.      SSiiggssttaacckk() will fail and the signal stack context will remain unchanged
  39.      if one of the following occurs.
  40.  
  41.      [EFAULT]  Either _s_s or _o_s_s points to memory that is not a valid part of
  42.                the process address space.
  43.  
  44. SSEEEE AALLSSOO
  45.      sigvec(2),  setjmp(3)
  46.  
  47. HHIISSTTOORRYY
  48.      The ssiiggssttaacckk function call appeared in 4.2BSD.
  49.  
  50. 4.2 Berkeley Distribution       March 10, 1991                               1
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.