|
DataMuseum.dkPresents historical artifacts from the history of: RC9000 |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about RC9000 Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - downloadIndex: u
Length: 3109 (0xc25)
Names: »usemop.2«
└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
└─⟦bbf173f5c⟧ »0004«
└─⟦this⟧ »./bsd/usr/man/cat2/usemop.2«
└─⟦this⟧ »./usr/man/cat2/usemop.2«
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 20 20 20 20 75 73 65 6d 6f 70 28 32 29 0a 0a 0a 0a ┆s usemop(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 75 73 65 6d 6f 70 20 2d 20 75 73 65 72 20 73 65 6d 61 70 68 6f 72 65 20 6f 70 65 72 61 74 ┆ usemop - user semaphore operat┆ 0x0a0…0c0 69 6f 6e 73 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 ┆ions S S S SY Y Y YN N N NT T T┆ 0x0c0…0e0 08 54 41 08 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 ┆ TA A A AX X X X # # # #i i┆ 0x0e0…100 08 69 08 69 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 ┆ i in n n nc c c cl l l lu u u u┆ 0x100…120 64 08 64 08 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 79 08 79 ┆d d d de e e e < < < <s s s sy y┆ 0x120…140 08 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f 74 08 74 08 74 08 74 79 08 79 08 79 08 79 ┆ y ys s s s/ / / /t t t ty y y y┆ 0x140…160 70 08 70 08 70 08 70 65 08 65 08 65 08 65 73 08 73 08 73 08 73 2e 08 2e 08 2e 08 2e 68 08 68 08 ┆p p p pe e e es s s s. . . .h h ┆ 0x160…180 68 08 68 3e 08 3e 08 3e 08 3e 0a 20 20 20 20 20 23 08 23 08 23 08 23 69 08 69 08 69 08 69 6e 08 ┆h h> > > > # # # #i i i in ┆ 0x180…1a0 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 64 08 ┆n n nc c c cl l l lu u u ud d d ┆ 0x1a0…1c0 64 65 08 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08 73 08 73 08 73 79 08 79 08 79 08 79 73 08 ┆de e e e < < < <s s s sy y y ys ┆ 0x1c0…1e0 73 08 73 08 73 2f 08 2f 08 2f 08 2f 69 08 69 08 69 08 69 70 08 70 08 70 08 70 63 08 63 08 63 08 ┆s s s/ / / /i i i ip p p pc c c ┆ 0x1e0…200 63 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 20 20 20 20 20 23 08 23 08 ┆c. . . .h h h h> > > > # # ┆ 0x200…220 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 63 6c 08 6c 08 6c 08 6c 75 ┆# #i i i in n n nc c c cl l l lu┆ 0x220…240 08 75 08 75 08 75 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08 73 08 ┆ u u ud d d de e e e < < < <s s ┆ 0x240…260 73 08 73 79 08 79 08 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f 73 08 73 08 73 08 73 65 ┆s sy y y ys s s s/ / / /s s s se┆ 0x260…280 08 65 08 65 08 65 6d 08 6d 08 6d 08 6d 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e ┆ e e em m m m. . . .h h h h> > >┆ 0x280…2a0 08 3e 0a 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 75 ┆ > i i i in n n nt t t t u┆ 0x2a0…2c0 08 75 08 75 08 75 73 08 73 08 73 08 73 65 08 65 08 65 08 65 6d 08 6d 08 6d 08 6d 6f 08 6f 08 6f ┆ u u us s s se e e em m m mo o o┆ 0x2c0…2e0 08 6f 70 08 70 08 70 08 70 28 08 28 08 28 08 28 75 08 75 08 75 08 75 73 08 73 08 73 08 73 65 08 ┆ op p p p( ( ( (u u u us s s se ┆ 0x2e0…300 65 08 65 08 65 6d 08 6d 08 6d 08 6d 2c 08 2c 08 2c 08 2c 20 75 08 75 08 75 08 75 6f 08 6f 08 6f ┆e e em m m m, , , , u u u uo o o┆ 0x300…320 08 6f 70 08 70 08 70 08 70 65 08 65 08 65 08 65 72 08 72 08 72 08 72 29 08 29 08 29 08 29 0a 20 ┆ op p p pe e e er r r r) ) ) ) ┆ 0x320…340 20 20 20 20 73 08 73 08 73 08 73 74 08 74 08 74 08 74 72 08 72 08 72 08 72 75 08 75 08 75 08 75 ┆ s s s st t t tr r r ru u u u┆ 0x340…360 63 08 63 08 63 08 63 74 08 74 08 74 08 74 20 75 08 75 08 75 08 75 73 08 73 08 73 08 73 65 08 65 ┆c c c ct t t t u u u us s s se e┆ 0x360…380 08 65 08 65 6d 08 6d 08 6d 08 6d 20 2a 08 2a 08 2a 08 2a 75 08 75 08 75 08 75 73 08 73 08 73 08 ┆ e em m m m * * * *u u u us s s ┆ 0x380…3a0 73 65 08 65 08 65 08 65 6d 08 6d 08 6d 08 6d 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 69 08 69 08 ┆se e e em m m m; ; ; ; i i ┆ 0x3a0…3c0 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 75 08 75 08 75 08 75 6f 08 6f 08 6f 08 6f ┆i in n n nt t t t u u u uo o o o┆ 0x3c0…3e0 70 08 70 08 70 08 70 65 08 65 08 65 08 65 72 08 72 08 72 08 72 3b 08 3b 08 3b 08 3b 0a 0a 44 08 ┆p p p pe e e er r r r; ; ; ; D ┆ 0x3e0…400 44 08 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 ┆D D DE E E ES S S SC C C CR R R ┆ 0x400…420 52 49 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 ┆RI I I IP P P PT T T TI I I IO O┆ 0x420…440 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 75 73 ┆ O ON N N N The function us┆ 0x440…460 65 6d 6f 70 20 69 73 20 75 73 65 64 20 74 6f 20 70 65 72 66 6f 72 6d 20 61 20 66 61 73 74 20 61 ┆emop is used to perform a fast a┆ 0x460…480 74 6f 6d 69 63 20 6f 70 65 72 61 2d 0a 20 20 20 20 20 74 69 6f 6e 20 6f 6e 20 61 20 62 69 6e 61 ┆tomic opera- tion on a bina┆ 0x480…4a0 72 79 20 73 65 6d 61 70 68 6f 72 65 20 64 65 66 69 6e 65 64 20 69 6e 20 75 73 65 72 20 73 70 61 ┆ry semaphore defined in user spa┆ 0x4a0…4c0 63 65 2e 20 20 54 68 65 20 6f 6e 6c 79 0a 20 20 20 20 20 76 61 6c 69 64 69 74 79 20 63 68 65 63 ┆ce. The only validity chec┆ 0x4c0…4e0 6b 20 70 65 72 66 6f 72 6d 65 64 20 6f 6e 20 74 68 65 20 75 73 65 72 20 73 75 70 70 6c 69 65 64 ┆k performed on the user supplied┆ 0x4e0…500 20 73 65 6d 61 70 68 6f 72 65 20 69 73 0a 20 20 20 20 20 74 68 61 74 20 69 74 20 6d 75 73 74 20 ┆ semaphore is that it must ┆ 0x500…520 62 65 20 6c 6f 63 61 74 65 64 20 69 6e 20 61 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 73 65 ┆be located in a shared memory se┆ 0x520…540 67 6d 65 6e 74 2e 20 20 4e 6f 20 73 79 73 2d 0a 20 20 20 20 20 74 65 6d 20 69 6d 70 6f 73 65 64 ┆gment. No sys- tem imposed┆ 0x540…560 20 62 6c 6f 63 6b 69 6e 67 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 69 66 20 74 72 79 69 6e 67 ┆ blocking is available if trying┆ 0x560…580 20 74 6f 20 6c 6f 63 6b 20 61 6e 0a 20 20 20 20 20 61 6c 72 65 61 64 79 20 6c 6f 63 6b 65 64 20 ┆ to lock an already locked ┆ 0x580…5a0 73 65 6d 61 70 68 6f 72 65 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 75 5f 08 73 5f 08 65 5f 08 ┆semaphore. The _ u_ s_ e_ ┆ 0x5a0…5c0 6d 20 73 74 72 75 63 74 75 72 65 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 ┆m structure includes the followi┆ 0x5c0…5e0 6e 67 20 6d 65 6d 62 65 72 73 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 75 5f 69 6e 74 20 20 20 6f ┆ng members: u_int o┆ 0x5e0…600 77 6e 65 72 3a 31 36 3b 20 20 20 20 20 20 20 2f 2a 20 6f 77 6e 65 72 20 6f 66 20 74 68 65 20 6c ┆wner:16; /* owner of the l┆ 0x600…620 6f 63 6b 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 75 5f 69 6e 74 20 20 20 72 65 73 65 76 3a 31 ┆ock */ u_int resev:1┆ 0x620…640 35 3b 20 20 20 20 20 20 20 2f 2a 20 72 65 73 65 72 76 65 64 20 66 6f 72 20 66 75 74 75 72 65 20 ┆5; /* reserved for future ┆ 0x640…660 75 73 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 75 5f 69 6e 74 20 20 20 6c 6f 63 6b 65 64 3a ┆use */ u_int locked:┆ 0x660…680 31 3b 20 20 20 20 20 20 20 2f 2a 20 74 68 65 20 6c 6f 63 6b 20 2a 2f 0a 0a 20 20 20 20 20 54 68 ┆1; /* the lock */ Th┆ 0x680…6a0 65 20 5f 08 75 5f 08 6f 5f 08 70 5f 08 65 5f 08 72 20 76 61 72 69 61 62 6c 65 20 6d 75 73 74 20 ┆e _ u_ o_ p_ e_ r variable must ┆ 0x6a0…6c0 73 70 65 63 69 66 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 65 ┆specify one of the following ope┆ 0x6c0…6e0 72 61 2d 0a 20 20 20 20 20 74 69 6f 6e 73 3a 0a 0a 20 20 20 20 20 55 53 5f 43 48 45 43 4b 20 20 ┆ra- tions: US_CHECK ┆ 0x6e0…700 69 6e 73 70 65 63 74 73 20 74 68 65 20 73 65 6d 61 70 68 6f 72 65 2c 0a 0a 20 20 20 20 20 55 53 ┆inspects the semaphore, US┆ 0x700…720 5f 4c 4f 43 4b 20 20 20 6c 6f 63 6b 20 74 68 65 20 73 65 6d 61 70 68 6f 72 65 2c 0a 0a 20 20 20 ┆_LOCK lock the semaphore, ┆ 0x720…740 20 20 55 53 5f 55 4e 4c 4f 43 4b 20 75 6e 6c 6f 63 6b 20 74 68 65 20 73 65 6d 61 70 68 6f 72 65 ┆ US_UNLOCK unlock the semaphore┆ 0x740…760 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 08 55 08 55 52 ┆. R R R RE E E ET T T TU U U UR┆ 0x760…780 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 41 4c 08 4c 08 ┆ R R RN N N N V V V VA A A AL L ┆ 0x780…7a0 4c 08 4c 55 08 55 08 55 08 55 45 08 45 08 45 08 45 0a 20 20 20 20 20 52 65 74 75 72 6e 20 69 73 ┆L LU U U UE E E E Return is┆ 0x7a0…7c0 20 61 6c 77 61 79 73 20 6d 61 64 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 61 6e 64 20 74 68 65 ┆ always made immediately and the┆ 0x7c0…7e0 20 72 65 74 75 72 6e 20 76 61 6c 75 65 0a 20 20 20 20 20 73 70 65 63 69 66 69 65 73 20 74 68 65 ┆ return value specifies the┆ 0x7e0…800 20 72 65 73 75 6c 74 3a 0a 0a 20 20 20 20 20 55 53 5f 4f 4b 3a 20 20 20 20 69 6e 64 69 63 61 74 ┆ result: US_OK: indicat┆ 0x800…820 65 73 20 74 68 61 74 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 73 75 63 63 65 64 65 64 2e 0a ┆es that the operation succeded. ┆ 0x820…840 0a 20 20 20 20 20 55 53 5f 4f 57 4e 45 52 3a 20 69 6e 20 63 61 73 65 20 6f 66 20 55 53 5f 43 48 ┆ US_OWNER: in case of US_CH┆ 0x840…860 45 43 4b 20 6f 70 65 72 61 74 69 6f 6e 2c 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68 ┆ECK operation, indicates that th┆ 0x860…880 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6c 6c 65 72 20 68 61 73 20 74 68 65 20 ┆e caller has the ┆ 0x880…8a0 6c 6f 63 6b 2e 0a 0a 20 20 20 20 20 55 53 5f 4e 4f 54 4f 57 4e 45 52 3a 0a 20 20 20 20 20 20 20 ┆lock. US_NOTOWNER: ┆ 0x8a0…8c0 20 20 20 20 20 20 20 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68 65 20 73 65 6d 61 70 ┆ indicates that the semap┆ 0x8c0…8e0 68 6f 72 65 20 69 73 20 61 6c 72 65 61 64 79 20 6c 6f 63 6b 65 64 2e 0a 0a 20 20 20 20 20 55 53 ┆hore is already locked. US┆ 0x8e0…900 5f 46 52 45 45 3a 20 20 6f 6e 6c 79 20 70 6f 73 73 69 62 6c 65 20 69 6e 20 63 61 73 65 20 6f 66 ┆_FREE: only possible in case of┆ 0x900…920 20 55 53 5f 43 48 45 43 4b 20 77 68 65 72 65 20 69 74 20 69 6e 64 69 2d 0a 20 20 20 20 20 20 20 ┆ US_CHECK where it indi- ┆ 0x920…940 20 20 20 20 20 20 20 20 63 61 74 65 73 20 74 68 61 74 20 74 68 65 20 73 65 6d 61 70 68 6f 72 65 ┆ cates that the semaphore┆ 0x940…960 20 69 73 20 66 72 65 65 2e 0a 0a 20 20 20 20 20 55 53 5f 45 52 52 4f 52 3a 20 74 68 65 20 6f 70 ┆ is free. US_ERROR: the op┆ 0x960…980 72 61 74 69 6f 6e 20 66 61 69 6c 65 64 20 61 6e 64 20 65 72 72 6e 6f 20 77 69 6c 6c 20 69 6e 64 ┆ration failed and errno will ind┆ 0x980…9a0 69 63 61 74 65 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 72 72 6f 72 2e 0a ┆icate the error. ┆ 0x9a0…9c0 0a 45 08 45 08 45 08 45 52 08 52 08 52 08 52 52 08 52 08 52 08 52 4f 08 4f 08 4f 08 4f 52 08 52 ┆ E E E ER R R RR R R RO O O OR R┆ 0x9c0…9e0 08 52 08 52 53 08 53 08 53 08 53 0a 20 20 20 20 20 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 75 73 ┆ R RS S S S The function us┆ 0x9e0…a00 65 6d 6f 70 20 77 69 6c 6c 20 66 61 69 6c 20 69 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 ┆emop will fail if one or more of┆ 0xa00…a20 20 74 68 65 20 66 6f 6c 6c 6f 77 2d 0a 20 20 20 20 20 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a ┆ the follow- ing are true: ┆ 0xa20…a40 0a 20 20 20 20 20 5b 45 41 43 43 45 53 5d 20 20 54 68 65 20 75 73 65 6d 20 76 61 72 69 61 62 6c ┆ [EACCES] The usem variabl┆ 0xa40…a60 65 20 69 73 20 6e 6f 74 20 6c 6f 63 61 74 65 64 20 69 6e 20 61 6e 20 28 61 74 74 61 63 68 65 64 ┆e is not located in an (attached┆ 0xa60…a80 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 20 73 ┆) shared memory s┆ 0xa80…aa0 65 67 6d 65 6e 74 20 6f 66 20 74 68 65 20 70 72 6f 63 65 73 73 2c 20 6f 72 20 74 68 65 0a 0a 0a ┆egment of the process, or the ┆ 0xaa0…ac0 0a 0a 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 68 61 72 65 64 20 6d 65 6d 6f 72 79 ┆ shared memory┆ 0xac0…ae0 20 73 65 67 6d 65 6e 74 20 77 61 73 20 61 74 74 61 63 68 65 64 20 77 69 74 68 20 72 65 61 64 5f ┆ segment was attached with read_┆ 0xae0…b00 6f 6e 6c 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 63 63 65 73 73 20 72 69 67 68 74 ┆only access right┆ 0xb00…b20 20 66 6f 72 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 2e 0a 0a 20 20 20 20 20 ┆ for the calling process. ┆ 0xb20…b40 5b 45 49 4e 56 41 4c 5d 20 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 75 6f 70 65 72 20 69 73 20 ┆[EINVAL] The value of uoper is ┆ 0xb40…b60 6e 6f 74 20 64 65 66 69 6e 65 64 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08 ┆not defined. S S S SE E E EE E ┆ 0xb60…b80 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 08 4f ┆E E A A A AL L L LS S S SO O O O┆ 0xb80…ba0 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 68 6d 63 74 6c 2c 20 ┆ System Calls (2): shmctl, ┆ 0xba0…bc0 73 68 6d 67 65 74 2c 20 73 68 6d 6f 70 2e 0a 0a 44 65 63 65 6d 62 65 72 20 31 39 38 39 20 20 20 ┆shmget, shmop. December 1989 ┆ 0xbc0…be0 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┆ 0xbe0…c00 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 ┆ 0xc00…c20 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 0a 0a 0a 0a 0a ┆ ┆ 0xc20…c25 0a 0a 0a 0a 0a ┆ ┆