DataMuseum.dk

top - download

    Length: 2213 (0x8a5)
    Names: »alarm.3c«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat3/alarm.3c« 

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 4c 69 62 72 61 72 79 20 46 75 6e 63 74   ┆ u_ a_ l           Library Funct┆
0x040…060 69 6f 6e 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6c 61 72 6d 28 33 63 29 0a 0a 0a 0a   ┆ions               alarm(3c)    ┆
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 61 6c 61 72 6d 20 2d 20 73 63 68 65 64 75 6c 65 20 61 6e 20 61 6c 61 72 6d 20 73 69 67 6e   ┆  alarm - schedule an alarm sign┆
0x0a0…0c0 61 6c 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   ┆al  S S S SY Y Y YN N N NT T T T┆
0x0c0…0e0 41 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 75 08 75 08 75 08 75 6e 08 6e 08 6e   ┆A A A AX X X X      u u u un n n┆
0x0e0…100 08 6e 73 08 73 08 73 08 73 69 08 69 08 69 08 69 67 08 67 08 67 08 67 6e 08 6e 08 6e 08 6e 65 08   ┆ ns s s si i i ig g g gn n n ne ┆
0x100…120 65 08 65 08 65 64 08 64 08 64 08 64 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74   ┆e e ed d d d i i i in n n nt t t┆
0x120…140 08 74 20 61 08 61 08 61 08 61 6c 08 6c 08 6c 08 6c 61 08 61 08 61 08 61 72 08 72 08 72 08 72 6d   ┆ t a a a al l l la a a ar r r rm┆
0x140…160 08 6d 08 6d 08 6d 28 08 28 08 28 08 28 73 08 73 08 73 08 73 65 08 65 08 65 08 65 63 08 63 08 63   ┆ m m m( ( ( (s s s se e e ec c c┆
0x160…180 08 63 6f 08 6f 08 6f 08 6f 6e 08 6e 08 6e 08 6e 64 08 64 08 64 08 64 73 08 73 08 73 08 73 29 08   ┆ co o o on n n nd d d ds s s s) ┆
0x180…1a0 29 08 29 08 29 0a 20 20 20 20 20 75 08 75 08 75 08 75 6e 08 6e 08 6e 08 6e 73 08 73 08 73 08 73   ┆) ) )      u u u un n n ns s s s┆
0x1a0…1c0 69 08 69 08 69 08 69 67 08 67 08 67 08 67 6e 08 6e 08 6e 08 6e 65 08 65 08 65 08 65 64 08 64 08   ┆i i i ig g g gn n n ne e e ed d ┆
0x1c0…1e0 64 08 64 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 73 08 73 08 73 08   ┆d d i i i in n n nt t t t s s s ┆
0x1e0…200 73 65 08 65 08 65 08 65 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 6e 08 6e 08 6e 08 6e 64 08 64   ┆se e e ec c c co o o on n n nd d┆
0x200…220 08 64 08 64 73 08 73 08 73 08 73 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 08 44 45 08 45 08 45   ┆ d ds s s s; ; ; ;  D D D DE E E┆
0x220…240 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 49 08 49 08 49 50 08   ┆ ES S S SC C C CR R R RI I I IP ┆
0x240…260 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 4f 4e 08 4e 08 4e 08   ┆P P PT T T TI I I IO O O ON N N ┆
0x260…280 4e 0a 20 20 20 20 20 5f 08 61 5f 08 6c 5f 08 61 5f 08 72 5f 08 6d 20 63 61 75 73 65 73 20 74 68   ┆N      _ a_ l_ a_ r_ m causes th┆
0x280…2a0 65 20 73 79 73 74 65 6d 20 74 6f 20 73 65 6e 64 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f   ┆e system to send the calling pro┆
0x2a0…2c0 63 65 73 73 20 61 0a 20 20 20 20 20 53 49 47 41 4c 52 4d 20 73 69 67 6e 61 6c 20 61 66 74 65 72   ┆cess a      SIGALRM signal after┆
0x2c0…2e0 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 61 6c 20 74 69 6d 65 20 73 65 63 6f 6e 64 73   ┆ the number of real time seconds┆
0x2e0…300 20 73 70 65 63 69 2d 0a 20 20 20 20 20 66 69 65 64 20 62 79 20 5f 08 73 5f 08 65 5f 08 63 5f 08   ┆ speci-      fied by _ s_ e_ c_ ┆
0x300…320 6f 5f 08 6e 5f 08 64 5f 08 73 20 68 61 76 65 20 65 6c 61 70 73 65 64 2e 20 50 72 6f 63 65 73 73   ┆o_ n_ d_ s have elapsed. Process┆
0x320…340 6f 72 20 73 63 68 65 64 75 6c 69 6e 67 20 64 65 6c 61 79 73 0a 20 20 20 20 20 6d 61 79 20 70 72   ┆or scheduling delays      may pr┆
0x340…360 65 76 65 6e 74 20 74 68 65 20 70 72 6f 63 65 73 73 20 66 72 6f 6d 20 68 61 6e 64 6c 69 6e 67 20   ┆event the process from handling ┆
0x360…380 74 68 65 20 73 69 67 6e 61 6c 20 61 73 20 73 6f 6f 6e 20 61 73 0a 20 20 20 20 20 69 74 20 69 73   ┆the signal as soon as      it is┆
0x380…3a0 20 67 65 6e 65 72 61 74 65 64 2e 0a 0a 20 20 20 20 20 49 66 20 5f 08 73 5f 08 65 5f 08 63 5f 08   ┆ generated.       If _ s_ e_ c_ ┆
0x3a0…3c0 6f 5f 08 6e 5f 08 64 5f 08 73 20 69 73 20 30 2c 20 61 20 70 65 6e 64 69 6e 67 20 61 6c 61 72 6d   ┆o_ n_ d_ s is 0, a pending alarm┆
0x3c0…3e0 20 72 65 71 75 65 73 74 2c 20 69 66 20 61 6e 79 2c 20 69 73 20 63 61 6e 2d 0a 20 20 20 20 20 63   ┆ request, if any, is can-      c┆
0x3e0…400 65 6c 6c 65 64 2e 0a 0a 20 20 20 20 20 41 6c 61 72 6d 20 72 65 71 75 65 73 74 73 20 61 72 65 20   ┆elled.       Alarm requests are ┆
0x400…420 6e 6f 74 20 73 74 61 63 6b 65 64 3b 20 6f 6e 6c 79 20 6f 6e 65 20 53 49 47 41 4c 52 4d 20 67 65   ┆not stacked; only one SIGALRM ge┆
0x420…440 6e 65 72 61 74 69 6f 6e 0a 20 20 20 20 20 63 61 6e 20 62 65 20 73 63 68 65 64 75 6c 65 64 20 69   ┆neration      can be scheduled i┆
0x440…460 6e 20 74 68 69 73 20 6d 61 6e 6e 65 72 3b 20 69 66 20 74 68 65 20 53 49 47 41 4c 52 4d 20 73 69   ┆n this manner; if the SIGALRM si┆
0x460…480 67 6e 61 6c 20 68 61 73 0a 20 20 20 20 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 67 65 6e 65 72   ┆gnal has      not yet been gener┆
0x480…4a0 61 74 65 64 2c 20 74 68 65 20 63 61 6c 6c 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 72 65   ┆ated, the call will result in re┆
0x4a0…4c0 73 63 68 65 64 75 6c 69 6e 67 0a 20 20 20 20 20 74 68 65 20 74 69 6d 65 20 61 74 20 77 68 69 63   ┆scheduling      the time at whic┆
0x4c0…4e0 68 20 74 68 65 20 53 49 47 41 4c 52 4d 20 73 69 67 6e 61 6c 20 77 69 6c 6c 20 62 65 20 67 65 6e   ┆h the SIGALRM signal will be gen┆
0x4e0…500 65 72 61 74 65 64 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   ┆erated.  R R R RE E E ET T T TU ┆
0x500…520 55 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   ┆U U UR R R RN N N N V V V VA A A┆
0x520…540 08 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 5f 08 61   ┆ AL L L LU U U UE E E E      _ a┆
0x540…560 5f 08 6c 5f 08 61 5f 08 72 5f 08 6d 20 72 65 74 75 72 6e 73 20 74 68 65 20 61 6d 6f 75 6e 74 20   ┆_ l_ a_ r_ m returns the amount ┆
0x560…580 6f 66 20 74 69 6d 65 2c 20 69 6e 20 73 65 63 6f 6e 64 73 2c 20 72 65 6d 61 69 6e 69 6e 67 0a 20   ┆of time, in seconds, remaining  ┆
0x580…5a0 20 20 20 20 62 65 66 6f 72 65 20 74 68 65 20 73 79 73 74 65 6d 20 69 73 20 73 63 68 65 64 75 6c   ┆    before the system is schedul┆
0x5a0…5c0 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 53 49 47 41 4c 52 4d 20 73 69 67 2d 0a   ┆ed to generate the SIGALRM sig- ┆
0x5c0…5e0 20 20 20 20 20 6e 61 6c 20 66 72 6f 6d 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 63 61 6c 6c 20   ┆     nal from the previous call ┆
0x5e0…600 74 6f 20 5f 08 61 5f 08 6c 5f 08 61 5f 08 72 5f 08 6d 20 6f 72 20 7a 65 72 6f 20 69 73 20 74 68   ┆to _ a_ l_ a_ r_ m or zero is th┆
0x600…620 65 72 65 20 77 61 73 20 6e 6f 0a 20 20 20 20 20 70 72 65 76 69 6f 75 73 20 5f 08 61 5f 08 6c 5f   ┆ere was no      previous _ a_ l_┆
0x620…640 08 61 5f 08 72 5f 08 6d 20 72 65 71 75 65 73 74 2e 0a 0a 45 08 45 08 45 08 45 52 08 52 08 52 08   ┆ a_ r_ m request.  E E E ER R R ┆
0x640…660 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 0a 20 20   ┆RR R R RO O O OR R R RS S S S   ┆
0x660…680 20 20 20 5f 08 61 5f 08 6c 5f 08 61 5f 08 72 5f 08 6d 20 69 73 20 61 6c 77 61 79 73 20 73 75 63   ┆   _ a_ l_ a_ r_ m is always suc┆
0x680…6a0 63 65 73 66 75 6c 2c 20 61 6e 64 20 6e 6f 20 65 72 72 6f 72 73 20 61 72 65 20 64 65 66 69 6e 65   ┆cesful, and no errors are define┆
0x6a0…6c0 64 2e 0a 0a 41 08 41 08 41 08 41 50 08 50 08 50 08 50 50 08 50 08 50 08 50 4c 08 4c 08 4c 08 4c   ┆d.  A A A AP P P PP P P PL L L L┆
0x6c0…6e0 49 08 49 08 49 08 49 43 08 43 08 43 08 43 41 08 41 08 41 08 41 54 08 54 08 54 08 54 49 08 49 08   ┆I I I IC C C CA A A AT T T TI I ┆
0x6e0…700 49 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 20 55 08 55 08 55 08 55 53 08 53 08 53 08 53   ┆I IO O O ON N N N U U U US S S S┆
0x700…720 41 08 41 08 41 08 41 47 08 47 08 47 08 47 45 08 45 08 45 08 45 0a 20 20 20 20 20 5f 08 66 5f 08   ┆A A A AG G G GE E E E      _ f_ ┆
0x720…740 6f 5f 08 72 5f 08 6b 20 63 6c 65 61 72 73 20 70 65 6e 64 69 6e 67 20 61 6c 61 72 6d 73 20 69 6e   ┆o_ r_ k clears pending alarms in┆
0x740…760 20 74 68 65 20 63 68 69 6c 64 20 70 72 6f 63 65 73 73 2e 20 41 20 6e 65 77 20 70 72 6f 2d 0a 20   ┆ the child process. A new pro-  ┆
0x760…780 20 20 20 20 63 65 73 73 20 69 6d 61 67 65 20 63 72 65 61 74 65 64 20 62 79 20 6f 6e 65 20 6f 66   ┆    cess image created by one of┆
0x780…7a0 20 74 68 65 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e 68 65   ┆ the _ e_ x_ e_ c functions inhe┆
0x7a0…7c0 72 69 74 73 20 74 68 65 0a 20 20 20 20 20 74 69 6d 65 20 6c 65 66 74 20 74 6f 20 61 6e 20 61 6c   ┆rits the      time left to an al┆
0x7c0…7e0 61 72 6d 20 73 69 67 6e 61 6c 20 69 6e 20 74 68 65 20 6f 6c 64 20 70 72 6f 63 65 73 73 27 20 69   ┆arm signal in the old process' i┆
0x7e0…800 6d 61 67 65 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08 45 08 45 20 41 08 41   ┆mage.  S S S SE E E EE E E E A A┆
0x800…820 08 41 08 41 4c 08 4c 08 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20 53   ┆ A AL L L LS S S SO O O O      S┆
0x820…840 79 73 74 65 6d 20 43 61 6c 6c 73 20 28 32 29 3a 20 20 65 78 65 63 2c 20 66 6f 72 6b 2c 20 70 61   ┆ystem Calls (2):  exec, fork, pa┆
0x840…860 75 73 65 2c 20 73 69 67 61 63 74 69 6f 6e 0a 0a 44 65 63 6d 65 62 65 72 20 31 39 39 30 20 20 20   ┆use, sigaction  Decmeber 1990   ┆
0x860…880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 58 20 50 72 6f 67 72   ┆                        TX Progr┆
0x880…8a0 61 6d 6d 65 72 27 73 20 52 65 66 65 72 65 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆ammer's Reference               ┆
0x8a0…8a5 0a 0a 0a 0a 0a                                                                                    ┆     ┆