DataMuseum.dk

top - download

    Length: 2357 (0x935)
    Names: »sigsuspend.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat2/sigsuspend.2« 

Default Hex Dump

0x000…020 0a 0a 0a 5f 08 4f 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 20 5f 08 4d 5f 08 61 5f 08 6e 5f   ┆   _ O_ n_ l_ i_ n_ e _ M_ a_ n_┆
0x020…040 08 75 5f 08 61 5f 08 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 53 79 73 74 65 6d 20 43 61 6c 6c   ┆ u_ a_ l             System Call┆
0x040…060 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67 73 75 73 70 65 6e 64 28 32 29 0a 0a 0a 0a   ┆s              sigsuspend(2)    ┆
0x060…080 4e 08 4e 08 4e 08 4e 41 08 41 08 41 08 41 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 0a 20 20 20   ┆N N N NA A A AM M M ME E E E    ┆
0x080…0a0 20 20 73 69 67 73 75 73 70 65 6e 64 20 2d 20 77 61 69 74 20 66 6f 72 20 61 20 73 69 67 6e 61 6c   ┆  sigsuspend - wait for a signal┆
0x0a0…0c0 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 41 08   ┆  S S S SY Y Y YN N N NT T T TA ┆
0x0c0…0e0 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 23 08 23 08 23 08 23 69 08 69 08 69 08 69   ┆A A AX X X X      # # # #i i i i┆
0x0e0…100 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 63 6c 08 6c 08 6c 08 6c 75 08 75 08 75 08 75 64 08 64 08   ┆n n n nc c c cl l l lu u u ud d ┆
0x100…120 64 08 64 65 08 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08 73 08 73 08 73 69 08 69 08 69 08 69   ┆d de e e e < < < <s s s si i i i┆
0x120…140 67 08 67 08 67 08 67 6e 08 6e 08 6e 08 6e 61 08 61 08 61 08 61 6c 08 6c 08 6c 08 6c 2e 08 2e 08   ┆g g g gn n n na a a al l l l. . ┆
0x140…160 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e   ┆. .h h h h> > > >       i i i in┆
0x160…180 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 73 08 73 08 73 08 73 69 08 69 08 69 08 69 67 08 67 08   ┆ n n nt t t t s s s si i i ig g ┆
0x180…1a0 67 08 67 73 08 73 08 73 08 73 75 08 75 08 75 08 75 73 08 73 08 73 08 73 70 08 70 08 70 08 70 65   ┆g gs s s su u u us s s sp p p pe┆
0x1a0…1c0 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 64 08 64 08 64 08 64 28 08 28 08 28 08 28 73 08 73 08 73   ┆ e e en n n nd d d d( ( ( (s s s┆
0x1c0…1e0 08 73 65 08 65 08 65 08 65 74 08 74 08 74 08 74 29 08 29 08 29 08 29 0a 20 20 20 20 20 73 08 73   ┆ se e e et t t t) ) ) )      s s┆
0x1e0…200 08 73 08 73 69 08 69 08 69 08 69 67 08 67 08 67 08 67 73 08 73 08 73 08 73 65 08 65 08 65 08 65   ┆ s si i i ig g g gs s s se e e e┆
0x200…220 74 08 74 08 74 08 74 5f 08 5f 08 5f 08 5f 74 08 74 08 74 08 74 20 2a 08 2a 08 2a 08 2a 73 08 73   ┆t t t t_ _ _ _t t t t * * * *s s┆
0x220…240 08 73 08 73 65 08 65 08 65 08 65 74 08 74 08 74 08 74 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44   ┆ s se e e et t t t; ; ; ;  D D D┆
0x240…260 08 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43 08 43 08 43 52 08 52 08 52 08 52 49 08   ┆ DE E E ES S S SC C C CR R R RI ┆
0x260…280 49 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54 49 08 49 08 49 08 49 4f 08 4f 08 4f 08   ┆I I IP P P PT T T TI I I IO O O ┆
0x280…2a0 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 5f 08 73 5f 08 69 5f 08 67 5f 08 73 5f 08 75 5f 08 73   ┆ON N N N      _ s_ i_ g_ s_ u_ s┆
0x2a0…2c0 5f 08 70 5f 08 65 5f 08 6e 5f 08 64 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 70 72 6f 63 65 73   ┆_ p_ e_ n_ d replaces the proces┆
0x2c0…2e0 73 27 73 20 63 75 72 72 65 6e 74 20 73 69 67 6e 61 6c 20 6d 61 73 6b 20 77 69 74 68 0a 20 20 20   ┆s's current signal mask with    ┆
0x2e0…300 20 20 74 68 65 20 73 65 74 20 6f 66 20 73 69 67 6e 61 6c 73 20 70 6f 69 6e 74 65 64 20 74 6f 20   ┆  the set of signals pointed to ┆
0x300…320 62 79 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 5f 08 73 5f 08 65 5f 08 74 20 61 6e 64 20 74 68   ┆by the argument _ s_ e_ t and th┆
0x320…340 65 6e 0a 20 20 20 20 20 73 75 73 70 65 6e 64 73 20 74 68 65 20 70 72 6f 63 65 73 73 20 75 6e 74   ┆en      suspends the process unt┆
0x340…360 69 6c 20 64 65 6c 69 76 65 72 79 20 6f 66 20 61 20 73 69 67 6e 61 6c 20 77 68 6f 73 65 20 61 63   ┆il delivery of a signal whose ac┆
0x360…380 74 69 6f 6e 0a 20 20 20 20 20 69 73 20 65 69 74 68 65 72 20 74 6f 20 65 78 65 63 75 74 65 20 61   ┆tion      is either to execute a┆
0x380…3a0 20 73 69 67 6e 61 6c 20 63 61 74 63 68 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 6f 72 20 74 6f 20   ┆ signal catching function or to ┆
0x3a0…3c0 74 65 72 2d 0a 20 20 20 20 20 6d 69 6e 61 74 65 20 74 68 65 20 70 72 6f 63 65 73 73 2e 0a 0a 20   ┆ter-      minate the process.   ┆
0x3c0…3e0 20 20 20 20 49 66 20 74 68 65 20 61 63 74 69 6f 6e 20 69 73 20 74 6f 20 74 65 72 6d 69 6e 61 74   ┆    If the action is to terminat┆
0x3e0…400 65 20 74 68 65 20 70 72 6f 63 65 73 73 2c 20 5f 08 73 5f 08 69 5f 08 67 5f 08 73 5f 08 75 5f 08   ┆e the process, _ s_ i_ g_ s_ u_ ┆
0x400…420 73 5f 08 70 5f 08 65 5f 08 6e 5f 08 64 20 64 6f 65 73 0a 20 20 20 20 20 6e 6f 74 20 72 65 74 75   ┆s_ p_ e_ n_ d does      not retu┆
0x420…440 72 6e 2e 20 20 49 66 20 74 68 65 20 61 63 74 69 6f 6e 20 69 73 20 74 6f 20 65 78 65 63 75 74 65   ┆rn.  If the action is to execute┆
0x440…460 20 61 20 73 69 67 6e 61 6c 20 63 61 74 63 68 69 6e 67 0a 20 20 20 20 20 66 75 6e 63 74 69 6f 6e   ┆ a signal catching      function┆
0x460…480 2c 20 5f 08 73 5f 08 69 5f 08 67 5f 08 73 5f 08 75 5f 08 73 5f 08 70 5f 08 65 5f 08 6e 5f 08 64   ┆, _ s_ i_ g_ s_ u_ s_ p_ e_ n_ d┆
0x480…4a0 20 72 65 74 75 72 6e 73 20 61 66 74 65 72 20 74 68 65 20 73 69 67 6e 61 6c 20 63 61 74 63 68 69   ┆ returns after the signal catchi┆
0x4a0…4c0 6e 67 20 66 75 6e 63 2d 0a 20 20 20 20 20 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 20 4f 6e 20   ┆ng func-      tion returns.  On ┆
0x4c0…4e0 72 65 74 75 72 6e 2c 20 74 68 65 20 73 69 67 6e 61 6c 20 6d 61 73 6b 20 69 73 20 72 65 73 74 6f   ┆return, the signal mask is resto┆
0x4e0…500 72 65 64 20 74 6f 20 74 68 65 0a 20 20 20 20 20 73 65 74 20 74 68 61 74 20 65 78 69 73 74 65 64   ┆red to the      set that existed┆
0x500…520 20 62 65 66 6f 72 65 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 5f 08 73 5f 08 69 5f 08 67 5f 08 73   ┆ before the call to _ s_ i_ g_ s┆
0x520…540 5f 08 75 5f 08 73 5f 08 70 5f 08 65 5f 08 6e 5f 08 64 2e 0a 0a 20 20 20 20 20 49 74 20 69 73 20   ┆_ u_ s_ p_ e_ n_ d.       It is ┆
0x540…560 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 62 6c 6f 63 6b 20 74 68 6f 73 65 20 73 69 67 6e   ┆not possible to block those sign┆
0x560…580 61 6c 73 20 74 68 61 74 20 63 61 6e 6e 6f 74 20 62 65 0a 20 20 20 20 20 69 67 6e 6f 72 65 64 3b   ┆als that cannot be      ignored;┆
0x580…5a0 20 74 68 69 73 20 72 65 73 74 72 69 63 74 69 6f 6e 20 69 73 20 73 69 6c 65 6e 74 6c 79 20 69 6d   ┆ this restriction is silently im┆
0x5a0…5c0 70 6f 73 65 64 20 62 79 20 74 68 65 20 73 79 73 74 65 6d 2e 0a 0a 45 08 45 08 45 08 45 52 08 52   ┆posed by the system.  E E E ER R┆
0x5c0…5e0 08 52 08 52 52 08 52 08 52 08 52 4f 08 4f 08 4f 08 4f 52 08 52 08 52 08 52 53 08 53 08 53 08 53   ┆ R RR R R RO O O OR R R RS S S S┆
0x5e0…600 0a 20 20 20 20 20 5f 08 73 5f 08 69 5f 08 67 5f 08 73 5f 08 75 5f 08 73 5f 08 70 5f 08 65 5f 08   ┆      _ s_ i_ g_ s_ u_ s_ p_ e_ ┆
0x600…620 6e 5f 08 64 20 66 61 69 6c 73 20 69 66 20 65 69 74 68 65 72 20 6f 66 20 74 68 65 20 66 6f 6c 6c   ┆n_ d fails if either of the foll┆
0x620…640 6f 77 69 6e 67 20 69 73 20 74 72 75 65 3a 0a 0a 20 20 20 20 20 5b 45 49 4e 54 52 5d 20 20 20 20   ┆owing is true:       [EINTR]    ┆
0x640…660 20 20 20 20 41 20 73 69 67 6e 61 6c 20 69 73 20 63 61 75 67 68 74 20 62 79 20 74 68 65 20 63 61   ┆    A signal is caught by the ca┆
0x660…680 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 20 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆lling process and               ┆
0x680…6a0 20 20 20 20 20 20 63 6f 6e 74 72 6f 6c 20 69 73 20 72 65 74 75 72 6e 65 64 20 66 72 6f 6d 20 74   ┆      control is returned from t┆
0x6a0…6c0 68 65 20 73 69 67 6e 61 6c 20 63 61 74 63 68 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆he signal catching              ┆
0x6c0…6e0 20 20 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 5b 45 46 41 55 4c 54 5d 20   ┆       function.       [EFAULT] ┆
0x6e0…700 20 20 20 20 20 20 54 68 65 20 5f 08 73 5f 08 65 5f 08 74 20 61 72 67 75 6d 65 6e 74 20 70 6f 69   ┆      The _ s_ e_ t argument poi┆
0x700…720 6e 74 73 20 6f 75 74 73 69 64 65 20 74 68 65 20 70 72 6f 63 65 73 73 27 73 0a 20 20 20 20 20 20   ┆nts outside the process's       ┆
0x720…740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6c 6c 6f 63 61 74 65 64 20 61 64 64 72 65 73 73 20   ┆              allocated address ┆
0x740…760 73 70 61 63 65 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08 45 08 45 54 08 54 08 54 08 54 55 08 55   ┆space.  R R R RE E E ET T T TU U┆
0x760…780 08 55 08 55 52 08 52 08 52 08 52 4e 08 4e 08 4e 08 4e 20 56 08 56 08 56 08 56 41 08 41 08 41 08   ┆ U UR R R RN N N N V V V VA A A ┆
0x780…7a0 41 4c 08 4c 08 4c 08 4c 55 08 55 08 55 08 55 45 08 45 08 45 08 45 0a 20 20 20 20 20 53 69 6e 63   ┆AL L L LU U U UE E E E      Sinc┆
0x7a0…7c0 65 20 5f 08 73 5f 08 69 5f 08 67 5f 08 73 5f 08 75 5f 08 73 5f 08 70 5f 08 65 5f 08 6e 5f 08 64   ┆e _ s_ i_ g_ s_ u_ s_ p_ e_ n_ d┆
0x7c0…7e0 20 73 75 73 70 65 6e 64 73 20 70 72 6f 63 65 73 73 20 65 78 65 63 75 74 69 6f 6e 20 69 6e 64 65   ┆ suspends process execution inde┆
0x7e0…800 66 69 6e 69 74 65 6c 79 2c 0a 20 20 20 20 20 74 68 65 72 65 20 69 73 20 6e 6f 20 73 75 63 63 65   ┆finitely,      there is no succe┆
0x800…820 73 73 66 75 6c 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 72 65 74 75 72 6e 20 76 61 6c 75 65 2e 20 20   ┆ssful completion return value.  ┆
0x820…840 4f 6e 20 66 61 69 6c 75 72 65 2c 0a 20 20 20 20 20 69 74 20 72 65 74 75 72 6e 73 20 2d 31 20 61   ┆On failure,      it returns -1 a┆
0x840…860 6e 64 20 73 65 74 73 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f 20 74 6f 20 69 6e 64 69 63   ┆nd sets _ e_ r_ r_ n_ o to indic┆
0x860…880 61 74 65 20 74 68 65 20 65 72 72 6f 72 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08   ┆ate the error.  S S S SE E E EE ┆
0x880…8a0 45 08 45 08 45 20 41 08 41 08 41 08 41 4c 08 4c 08 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f   ┆E E E A A A AL L L LS S S SO O O┆
0x8a0…8c0 08 4f 0a 20 20 20 20 20 53 79 73 74 65 6d 20 43 61 6c 6c 73 20 28 32 29 3a 20 73 69 67 61 63 74   ┆ O      System Calls (2): sigact┆
0x8c0…8e0 69 6f 6e 2c 20 73 69 67 70 72 6f 63 6d 61 73 6b 2c 20 70 61 75 73 65 2c 20 73 69 67 73 65 74 6f   ┆ion, sigprocmask, pause, sigseto┆
0x8e0…900 70 73 0a 0a 44 65 63 65 6d 62 65 72 20 31 39 39 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆ps  December 1990               ┆
0x900…920 20 20 20 20 20 20 20 20 20 20 20 20 54 58 20 50 72 6f 67 72 61 6d 6d 65 72 27 73 20 52 65 66 65   ┆            TX Programmer's Refe┆
0x920…935 72 65 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a                                    ┆rence                ┆