DataMuseum.dk

top - download

    Length: 2220 (0x8ac)
    Names: »getgroups.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./bsd/usr/man/cat2/getgroups.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 20 67 65 74 67 72 6f 75 70 73 28 32 29 0a 0a 0a 0a   ┆s               getgroups(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 67 65 74 67 72 6f 75 70 73 20 2d 20 67 65 74 20 67 72 6f 75 70 2d 61 63 63 65 73 73 20 6c   ┆  getgroups - get group-access l┆
0x0a0…0c0 69 73 74 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   ┆ist  S S S SY Y Y YN N N NT T T ┆
0x0c0…0e0 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 08   ┆TA A A AX X X X      # # # #i i ┆
0x0e0…100 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 64   ┆i in n n nc c c cl l l lu u u ud┆
0x100…120 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 08   ┆ d d de e e e < < < <s s s sy y ┆
0x120…140 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f 70 08 70 08 70 08 70 61 08 61 08 61 08 61 72   ┆y ys s s s/ / / /p p p pa a a ar┆
0x140…160 08 72 08 72 08 72 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 2e 08 2e 08 2e 08 2e 68 08 68 08 68   ┆ r r ra a a am m m m. . . .h h h┆
0x160…180 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20 20 20 20 20 6e 08 6e 08 6e 08 6e 67 08 67 08 67 08 67 72 08   ┆ h> > > >       n n n ng g g gr ┆
0x180…1a0 72 08 72 08 72 6f 08 6f 08 6f 08 6f 75 08 75 08 75 08 75 70 08 70 08 70 08 70 73 08 73 08 73 08   ┆r r ro o o ou u u up p p ps s s ┆
0x1a0…1c0 73 20 3d 08 3d 08 3d 08 3d 20 67 08 67 08 67 08 67 65 08 65 08 65 08 65 74 08 74 08 74 08 74 67   ┆s = = = = g g g ge e e et t t tg┆
0x1c0…1e0 08 67 08 67 08 67 72 08 72 08 72 08 72 6f 08 6f 08 6f 08 6f 75 08 75 08 75 08 75 70 08 70 08 70   ┆ g g gr r r ro o o ou u u up p p┆
0x1e0…200 08 70 73 08 73 08 73 08 73 28 08 28 08 28 08 28 67 08 67 08 67 08 67 69 08 69 08 69 08 69 64 08   ┆ ps s s s( ( ( (g g g gi i i id ┆
0x200…220 64 08 64 08 64 73 08 73 08 73 08 73 65 08 65 08 65 08 65 74 08 74 08 74 08 74 6c 08 6c 08 6c 08   ┆d d ds s s se e e et t t tl l l ┆
0x220…240 6c 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 2c 08 2c 08 2c 08 2c 20 67 08 67 08 67 08 67 69 08   ┆le e e en n n n, , , , g g g gi ┆
0x240…260 69 08 69 08 69 64 08 64 08 64 08 64 73 08 73 08 73 08 73 65 08 65 08 65 08 65 74 08 74 08 74 08   ┆i i id d d ds s s se e e et t t ┆
0x260…280 74 29 08 29 08 29 08 29 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08   ┆t) ) ) )      i i i in n n nt t ┆
0x280…2a0 74 08 74 20 6e 08 6e 08 6e 08 6e 67 08 67 08 67 08 67 72 08 72 08 72 08 72 6f 08 6f 08 6f 08 6f   ┆t t n n n ng g g gr r r ro o o o┆
0x2a0…2c0 75 08 75 08 75 08 75 70 08 70 08 70 08 70 73 08 73 08 73 08 73 2c 08 2c 08 2c 08 2c 20 67 08 67   ┆u u u up p p ps s s s, , , , g g┆
0x2c0…2e0 08 67 08 67 69 08 69 08 69 08 69 64 08 64 08 64 08 64 73 08 73 08 73 08 73 65 08 65 08 65 08 65   ┆ g gi i i id d d ds s s se e e e┆
0x2e0…300 74 08 74 08 74 08 74 6c 08 6c 08 6c 08 6c 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 2c 08 2c 08   ┆t t t tl l l le e e en n n n, , ┆
0x300…320 2c 08 2c 20 2a 08 2a 08 2a 08 2a 67 08 67 08 67 08 67 69 08 69 08 69 08 69 64 08 64 08 64 08 64   ┆, , * * * *g g g gi i i id d d d┆
0x320…340 73 08 73 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   ┆s s s se e e et t t t; ; ; ;  D ┆
0x340…360 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 ┆
0x360…380 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┆
0x380…3a0 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 5f 08 67 5f 08 65 5f 08 74 5f 08 67 5f 08 72   ┆ O ON N N N      _ g_ e_ t_ g_ r┆
0x3a0…3c0 5f 08 6f 5f 08 75 5f 08 70 5f 08 73 20 67 65 74 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 67 72   ┆_ o_ u_ p_ s gets the current gr┆
0x3c0…3e0 6f 75 70 2d 61 63 63 65 73 73 20 6c 69 73 74 20 6f 66 20 74 68 65 20 75 73 65 72 0a 20 20 20 20   ┆oup-access list of the user     ┆
0x3e0…400 20 70 72 6f 63 65 73 73 20 61 6e 64 20 73 74 6f 72 65 73 20 69 74 20 69 6e 20 74 68 65 20 61 72   ┆ process and stores it in the ar┆
0x400…420 72 61 79 20 5f 08 67 5f 08 69 5f 08 64 5f 08 73 5f 08 65 5f 08 74 2e 20 20 54 68 65 20 70 61 72   ┆ray _ g_ i_ d_ s_ e_ t.  The par┆
0x420…440 61 6d 65 74 65 72 0a 20 20 20 20 20 5f 08 67 5f 08 69 5f 08 64 5f 08 73 5f 08 65 5f 08 74 5f 08   ┆ameter      _ g_ i_ d_ s_ e_ t_ ┆
0x440…460 6c 5f 08 65 5f 08 6e 20 69 6e 64 69 63 61 74 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20   ┆l_ e_ n indicates the number of ┆
0x460…480 65 6e 74 72 69 65 73 20 74 68 61 74 20 6d 61 79 20 62 65 20 70 6c 61 63 65 64 0a 20 20 20 20 20   ┆entries that may be placed      ┆
0x480…4a0 69 6e 20 5f 08 67 5f 08 69 5f 08 64 5f 08 73 5f 08 65 5f 08 74 2e 20 20 5f 08 67 5f 08 65 5f 08   ┆in _ g_ i_ d_ s_ e_ t.  _ g_ e_ ┆
0x4a0…4c0 74 5f 08 67 5f 08 72 5f 08 6f 5f 08 75 5f 08 70 5f 08 73 20 72 65 74 75 72 6e 73 20 74 68 65 20   ┆t_ g_ r_ o_ u_ p_ s returns the ┆
0x4c0…4e0 61 63 74 75 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 67 72 6f 75 70 73 0a 20 20 20 20 20 72 65 74   ┆actual number of groups      ret┆
0x4e0…500 75 72 6e 65 64 20 69 6e 20 5f 08 67 5f 08 69 5f 08 64 5f 08 73 5f 08 65 5f 08 74 2e 20 20 4e 6f   ┆urned in _ g_ i_ d_ s_ e_ t.  No┆
0x500…520 20 6d 6f 72 65 20 74 68 61 6e 20 4e 47 52 4f 55 50 53 20 28 61 73 20 64 65 66 69 6e 65 64 20 69   ┆ more than NGROUPS (as defined i┆
0x520…540 6e 0a 20 20 20 20 20 3c 73 79 73 2f 70 61 72 61 6d 2e 68 3e 29 20 77 69 6c 6c 20 65 76 65 72 20   ┆n      <sys/param.h>) will ever ┆
0x540…560 62 65 20 72 65 74 75 72 6e 65 64 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08 45 08 45 54 08 54 08   ┆be returned.  R R R RE E E ET T ┆
0x560…580 54 08 54 55 08 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   ┆T TU U U UR R R RN N N N V V V V┆
0x580…5a0 41 08 41 08 41 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   ┆A A A AL L L LU U U UE E E E    ┆
0x5a0…5c0 20 20 41 20 73 75 63 63 65 73 73 66 75 6c 20 63 61 6c 6c 20 72 65 74 75 72 6e 73 20 74 68 65 20   ┆  A successful call returns the ┆
0x5c0…5e0 6e 75 6d 62 65 72 20 6f 66 20 67 72 6f 75 70 73 20 69 6e 20 74 68 65 20 67 72 6f 75 70 0a 20 20   ┆number of groups in the group   ┆
0x5e0…600 20 20 20 73 65 74 2e 20 20 41 20 76 61 6c 75 65 20 6f 66 20 2d 31 20 69 6e 64 69 63 61 74 65 73   ┆   set.  A value of -1 indicates┆
0x600…620 20 74 68 61 74 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2c 20 61 6e 64 0a 20 20 20   ┆ that an error occurred, and    ┆
0x620…640 20 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68   ┆  the error code is stored in th┆
0x640…660 65 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08   ┆e global variable _ e_ r_ r_ n_ ┆
0x660…680 6f 2e 0a 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   ┆o.  E E E ER R R RR R R RO O O O┆
0x680…6a0 52 08 52 08 52 08 52 53 08 53 08 53 08 53 0a 20 20 20 20 20 54 68 65 20 70 6f 73 73 69 62 6c 65   ┆R R R RS S S S      The possible┆
0x6a0…6c0 20 65 72 72 6f 72 73 20 66 6f 72 20 5f 08 67 5f 08 65 5f 08 74 5f 08 67 5f 08 72 5f 08 6f 5f 08   ┆ errors for _ g_ e_ t_ g_ r_ o_ ┆
0x6c0…6e0 75 5f 08 70 5f 08 73 20 61 72 65 3a 0a 0a 20 20 20 20 20 5b 45 46 41 55 4c 54 5d 20 20 20 20 20   ┆u_ p_ s are:       [EFAULT]     ┆
0x6e0…700 20 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 5f 08 6e 5f 08 67 5f 08 72 5f 08 6f 5f 08 75 5f   ┆  The arguments _ n_ g_ r_ o_ u_┆
0x700…720 08 70 5f 08 73 20 6f 72 20 5f 08 67 5f 08 69 5f 08 64 5f 08 73 5f 08 65 5f 08 74 20 73 70 65 63   ┆ p_ s or _ g_ i_ d_ s_ e_ t spec┆
0x720…740 69 66 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 76 61 6c 69 64 20   ┆ify                     invalid ┆
0x740…760 61 64 64 72 65 73 73 65 73 2e 0a 0a 20 20 20 20 20 5b 45 49 4e 56 41 4c 5d 20 20 20 20 20 20 20   ┆addresses.       [EINVAL]       ┆
0x760…780 54 68 65 20 61 72 67 75 6d 65 6e 74 20 5f 08 67 5f 08 69 5f 08 64 5f 08 73 5f 08 65 5f 08 74 5f   ┆The argument _ g_ i_ d_ s_ e_ t_┆
0x780…7a0 08 6c 5f 08 65 5f 08 6e 20 69 73 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 74 68 65 0a 20 20 20   ┆ l_ e_ n is smaller than the    ┆
0x7a0…7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 75 6d 62 65 72 20 6f 66 20 67 72 6f 75 70   ┆                 number of group┆
0x7c0…7e0 73 20 69 6e 20 74 68 65 20 67 72 6f 75 70 20 73 65 74 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08   ┆s in the group set.  S S S SE E ┆
0x7e0…800 45 08 45 45 08 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   ┆E EE E E E A A A AL L L LS S S S┆
0x800…820 4f 08 4f 08 4f 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 20   ┆O O O O      System Calls (2):  ┆
0x820…840 73 65 74 67 72 6f 75 70 73 0a 20 20 20 20 20 4c 69 62 72 61 72 79 20 46 75 6e 63 74 69 6f 6e 73   ┆setgroups      Library Functions┆
0x840…860 20 28 33 29 3a 20 20 69 6e 69 74 67 72 6f 75 70 73 0a 0a 4d 61 72 63 68 20 31 39 38 39 20 20 20   ┆ (3):  initgroups  March 1989   ┆
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 20 20 20 54 58 20 50 72   ┆                           TX Pr┆
0x880…8a0 6f 67 72 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   ┆ogrammer's Reference            ┆
0x8a0…8ac 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a                                                               ┆            ┆