DataMuseum.dk

top - download

    Length: 1824 (0x720)
    Names: »usleep.3«

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

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 75 73 6c 65 65 70 28 33 29 0a 0a 0a 0a   ┆ions               usleep(3)    ┆
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 75 73 6c 65 65 70 20 2d 20 73 75 73 70 65 6e 64 20 65 78 65 63 75 74 69 6f 6e 20 66 6f 72   ┆  usleep - suspend execution for┆
0x0a0…0c0 20 61 6e 20 69 6e 74 65 72 76 61 6c 20 73 70 65 63 69 66 69 65 64 20 69 6e 0a 20 20 20 20 20 6d   ┆ an interval specified in      m┆
0x0c0…0e0 69 63 72 6f 73 65 63 65 6f 6e 64 73 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08   ┆icroseceonds  S S S SY Y Y YN N ┆
0x0e0…100 4e 08 4e 4f 08 4f 08 4f 08 4f 50 08 50 08 50 08 50 53 08 53 08 53 08 53 49 08 49 08 49 08 49 53   ┆N NO O O OP P P PS S S SI I I IS┆
0x100…120 08 53 08 53 08 53 0a 20 20 20 20 20 75 08 75 08 75 08 75 73 08 73 08 73 08 73 6c 08 6c 08 6c 08   ┆ S S S      u u u us s s sl l l ┆
0x120…140 6c 65 08 65 08 65 08 65 65 08 65 08 65 08 65 70 08 70 08 70 08 70 28 08 28 08 28 08 28 75 08 75   ┆le e e ee e e ep p p p( ( ( (u u┆
0x140…160 08 75 08 75 73 08 73 08 73 08 73 65 08 65 08 65 08 65 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f   ┆ u us s s se e e ec c c co o o o┆
0x160…180 6e 08 6e 08 6e 08 6e 64 08 64 08 64 08 64 73 08 73 08 73 08 73 29 08 29 08 29 08 29 0a 20 20 20   ┆n n n nd d d ds s s s) ) ) )    ┆
0x180…1a0 20 20 75 08 75 08 75 08 75 6e 08 6e 08 6e 08 6e 73 08 73 08 73 08 73 69 08 69 08 69 08 69 67 08   ┆  u u u un n n ns s s si i i ig ┆
0x1a0…1c0 67 08 67 08 67 6e 08 6e 08 6e 08 6e 65 08 65 08 65 08 65 64 08 64 08 64 08 64 20 75 08 75 08 75   ┆g g gn n n ne e e ed d d d u u u┆
0x1c0…1e0 08 75 73 08 73 08 73 08 73 65 08 65 08 65 08 65 63 08 63 08 63 08 63 6f 08 6f 08 6f 08 6f 6e 08   ┆ us s s se e e ec c c co o o on ┆
0x1e0…200 6e 08 6e 08 6e 64 08 64 08 64 08 64 73 08 73 08 73 08 73 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08   ┆n n nd d d ds s s s; ; ; ;  D D ┆
0x200…220 44 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   ┆D DE E E ES S S SC C C CR R R RI┆
0x220…240 08 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   ┆ I I IP P P PT T T TI I I IO O O┆
0x240…260 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 63 75 72 72 65 6e 74 20 70 72 6f 63 65   ┆ ON N N N      The current proce┆
0x260…280 73 73 20 69 73 20 73 75 73 70 65 6e 64 65 64 20 66 72 6f 6d 20 65 78 65 63 75 74 69 6f 6e 20 66   ┆ss is suspended from execution f┆
0x280…2a0 6f 72 20 74 68 65 0a 20 20 20 20 20 6e 75 6d 62 65 72 20 6f 66 20 6d 69 63 72 6f 73 65 63 6f 6e   ┆or the      number of microsecon┆
0x2a0…2c0 64 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 61 72 67 75 6d 65 6e 74 2e 20 20 54   ┆ds specified by the argument.  T┆
0x2c0…2e0 68 65 0a 20 20 20 20 20 61 63 74 75 61 6c 20 73 75 73 70 65 6e 73 69 6f 6e 20 74 69 6d 65 20 6d   ┆he      actual suspension time m┆
0x2e0…300 61 79 20 62 65 20 61 6e 20 61 72 62 69 74 72 61 72 79 20 61 6d 6f 75 6e 74 20 6c 6f 6e 67 65 72   ┆ay be an arbitrary amount longer┆
0x300…320 0a 20 20 20 20 20 62 65 63 61 75 73 65 20 6f 66 20 6f 74 68 65 72 20 61 63 74 69 76 69 74 79 20   ┆      because of other activity ┆
0x320…340 69 6e 20 74 68 65 20 73 79 73 74 65 6d 20 6f 72 20 62 65 63 61 75 73 65 20 6f 66 20 74 68 65 0a   ┆in the system or because of the ┆
0x340…360 20 20 20 20 20 74 69 6d 65 20 73 70 65 6e 74 20 69 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 74 68   ┆     time spent in processing th┆
0x360…380 65 20 63 61 6c 6c 2e 0a 0a 20 20 20 20 20 54 68 65 20 72 6f 75 74 69 6e 65 20 69 73 20 69 6d 70   ┆e call.       The routine is imp┆
0x380…3a0 6c 65 6d 65 6e 74 65 64 20 62 79 20 73 65 74 74 69 6e 67 20 61 6e 20 69 6e 74 65 72 76 61 6c 20   ┆lemented by setting an interval ┆
0x3a0…3c0 74 69 6d 65 72 20 61 6e 64 0a 20 20 20 20 20 70 61 75 73 69 6e 67 20 75 6e 74 69 6c 20 69 74 20   ┆timer and      pausing until it ┆
0x3c0…3e0 6f 63 63 75 72 73 2e 20 20 54 68 65 20 70 72 65 76 69 6f 75 73 20 73 74 61 74 65 20 6f 66 20 74   ┆occurs.  The previous state of t┆
0x3e0…400 68 69 73 20 74 69 6d 65 72 0a 20 20 20 20 20 69 73 20 73 61 76 65 64 20 61 6e 64 20 72 65 73 74   ┆his timer      is saved and rest┆
0x400…420 6f 72 65 64 2e 20 20 49 66 20 74 68 65 20 73 6c 65 65 70 20 74 69 6d 65 20 65 78 63 65 65 64 73   ┆ored.  If the sleep time exceeds┆
0x420…440 20 74 68 65 20 74 69 6d 65 0a 20 20 20 20 20 74 6f 20 74 68 65 20 65 78 70 69 72 61 74 69 6f 6e   ┆ the time      to the expiration┆
0x440…460 20 6f 66 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 74 69 6d 65 72 2c 20 74 68 65 20 70 72 6f 63   ┆ of the previous timer, the proc┆
0x460…480 65 73 73 20 73 6c 65 65 70 73 0a 20 20 20 20 20 6f 6e 6c 79 20 75 6e 74 69 6c 20 74 68 65 20 73   ┆ess sleeps      only until the s┆
0x480…4a0 69 67 6e 61 6c 20 77 6f 75 6c 64 20 68 61 76 65 20 6f 63 63 75 72 72 65 64 2c 20 61 6e 64 20 74   ┆ignal would have occurred, and t┆
0x4a0…4c0 68 65 20 73 69 67 6e 61 6c 20 69 73 0a 20 20 20 20 20 73 65 6e 74 20 61 20 73 68 6f 72 74 20 74   ┆he signal is      sent a short t┆
0x4c0…4e0 69 6d 65 20 6c 61 74 65 72 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   ┆ime later.       This routine is┆
0x4e0…500 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 75 73 69 6e 67 20 5f 08 73 5f 08 65 5f 08 74 5f 08 69 5f   ┆ implemented using _ s_ e_ t_ i_┆
0x500…520 08 74 5f 08 69 5f 08 6d 5f 08 65 5f 08 72 28 32 29 3b 20 69 74 20 72 65 71 75 69 72 65 73 0a 20   ┆ t_ i_ m_ e_ r(2); it requires  ┆
0x520…540 20 20 20 20 65 69 67 68 74 20 73 79 73 74 65 6d 20 63 61 6c 6c 73 20 65 61 63 68 20 74 69 6d 65   ┆    eight system calls each time┆
0x540…560 20 69 74 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 41 20 73 69 6d 69 6c 61 72 20 62 75 74 0a 20   ┆ it is invoked.  A similar but  ┆
0x560…580 20 20 20 20 6c 65 73 73 20 63 6f 6d 70 61 74 69 62 6c 65 20 66 75 6e 63 74 69 6f 6e 20 63 61 6e   ┆    less compatible function can┆
0x580…5a0 20 62 65 20 6f 62 74 61 69 6e 65 64 20 77 69 74 68 20 61 20 73 69 6e 67 6c 65 0a 20 20 20 20 20   ┆ be obtained with a single      ┆
0x5a0…5c0 5f 08 73 5f 08 65 5f 08 6c 5f 08 65 5f 08 63 5f 08 74 28 32 29 3b 20 69 74 20 77 6f 75 6c 64 20   ┆_ s_ e_ l_ e_ c_ t(2); it would ┆
0x5c0…5e0 6e 6f 74 20 72 65 73 74 61 72 74 20 61 66 74 65 72 20 73 69 67 6e 61 6c 73 2c 20 62 75 74 20 77   ┆not restart after signals, but w┆
0x5e0…600 6f 75 6c 64 20 6e 6f 74 0a 20 20 20 20 20 69 6e 74 65 72 66 65 72 65 20 77 69 74 68 20 6f 74 68   ┆ould not      interfere with oth┆
0x600…620 65 72 20 75 73 65 73 20 6f 66 20 5f 08 73 5f 08 65 5f 08 74 5f 08 69 5f 08 74 5f 08 69 5f 08 6d   ┆er uses of _ s_ e_ t_ i_ t_ i_ m┆
0x620…640 5f 08 65 5f 08 72 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   ┆_ e_ r.  S S S SE E E EE E E E A┆
0x640…660 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 08 4f 0a 20 20 20 20   ┆ A A AL L L LS S S SO O O O     ┆
0x660…680 20 53 79 73 74 65 6d 20 43 61 6c 6c 73 20 28 32 29 3a 20 73 65 74 69 74 69 6d 65 72 2c 20 67 65   ┆ System Calls (2): setitimer, ge┆
0x680…6a0 74 69 74 69 6d 65 72 2c 20 73 69 67 70 61 75 73 65 0a 20 20 20 20 20 4c 69 62 72 61 72 79 20 46   ┆titimer, sigpause      Library F┆
0x6a0…6c0 75 6e 63 74 69 6f 6e 73 20 28 33 29 3a 20 61 6c 61 72 6d 2c 20 73 6c 65 65 70 2c 20 75 61 6c 61   ┆unctions (3): alarm, sleep, uala┆
0x6c0…6e0 72 6d 0a 0a 41 75 67 75 73 74 20 31 39 39 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆rm  August 1991                 ┆
0x6e0…700 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┆
0x700…720 72 65 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆rence                           ┆