DataMuseum.dk

top - download

    Length: 2343 (0x927)
    Names: »getgroups.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./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 73 75 70 70 6c 65 6d 65 6e 74 61 72 79 20   ┆  getgroups - get supplementary ┆
0x0a0…0c0 67 72 6f 75 70 20 49 44 73 2e 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08   ┆group IDs.  S S S SY Y Y YN N N ┆
0x0c0…0e0 4e 54 08 54 08 54 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   ┆NT T T TA A A AX X X X      # # ┆
0x0e0…100 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┆
0x100…120 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 ┆
0x120…140 73 08 73 79 08 79 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   ┆s sy y y ys s s s/ / / /t t t ty┆
0x140…160 08 79 08 79 08 79 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   ┆ y y yp p p pe e e es s s s. . .┆
0x160…180 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 08   ┆ .h h h h> > > >       i i i in ┆
0x180…1a0 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 67 08 67 08 67 08 67 65 08 65 08 65 08 65 74 08 74 08 74   ┆n n nt t t t g g g ge e e et t t┆
0x1a0…1c0 08 74 67 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   ┆ tg g g gr r r ro o o ou u u up ┆
0x1c0…1e0 70 08 70 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   ┆p p ps s s s( ( ( (g g g gi i i ┆
0x1e0…200 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 74 73 08 73   ┆id d d ds s s se e e et t t ts s┆
0x200…220 08 73 08 73 69 08 69 08 69 08 69 7a 08 7a 08 7a 08 7a 65 08 65 08 65 08 65 2c 08 2c 08 2c 08 2c   ┆ s si i i iz z z ze e e e, , , ,┆
0x220…240 20 67 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   ┆ g g g gr r r ro o o ou u u up p┆
0x240…260 08 70 08 70 6c 08 6c 08 6c 08 6c 69 08 69 08 69 08 69 73 08 73 08 73 08 73 74 08 74 08 74 08 74   ┆ p pl l l li i i is s s st t t t┆
0x260…280 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 74   ┆) ) ) )      i i i in n n nt t t┆
0x280…2a0 08 74 20 67 08 67 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   ┆ t g g g gi i i id d d ds s s se┆
0x2a0…2c0 08 65 08 65 08 65 74 08 74 08 74 08 74 73 08 73 08 73 08 73 69 08 69 08 69 08 69 7a 08 7a 08 7a   ┆ e e et t t ts s s si i i iz z z┆
0x2c0…2e0 08 7a 65 08 65 08 65 08 65 3b 08 3b 08 3b 08 3b 0a 20 20 20 20 20 67 08 67 08 67 08 67 69 08 69   ┆ ze e e e; ; ; ;      g g g gi i┆
0x2e0…300 08 69 08 69 64 08 64 08 64 08 64 5f 08 5f 08 5f 08 5f 74 08 74 08 74 08 74 20 67 08 67 08 67 08   ┆ i id d d d_ _ _ _t t t t g g g ┆
0x300…320 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 08 70 6c 08 6c   ┆gr r r ro o o ou u u up p p pl l┆
0x320…340 08 6c 08 6c 69 08 69 08 69 08 69 73 08 73 08 73 08 73 74 08 74 08 74 08 74 5b 08 5b 08 5b 08 5b   ┆ l li i i is s s st t t t[ [ [ [┆
0x340…360 5d 08 5d 08 5d 08 5d 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 08 44 45 08 45 08 45 08 45 53 08   ┆] ] ] ]; ; ; ;  D D D DE E E ES ┆
0x360…380 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 50 08 50 08   ┆S S SC C C CR R R RI I I IP P P ┆
0x380…3a0 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 4e 0a 20 20   ┆PT T T TI I I IO O O ON N N N   ┆
0x3a0…3c0 20 20 20 5f 08 67 5f 08 65 5f 08 74 5f 08 67 5f 08 72 5f 08 6f 5f 08 75 5f 08 70 5f 08 73 20 67   ┆   _ g_ e_ t_ g_ r_ o_ u_ p_ s g┆
0x3c0…3e0 65 74 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 75 70 70 6c 65 6d 65 6e 74 61 6c 20 67 72 6f   ┆ets the current supplemental gro┆
0x3e0…400 75 70 20 61 63 63 65 73 73 20 6c 69 73 74 20 6f 66 0a 20 20 20 20 20 74 68 65 20 63 61 6c 6c 69   ┆up access list of      the calli┆
0x400…420 6e 67 20 70 72 6f 63 65 73 73 20 61 6e 64 20 73 74 6f 72 65 73 20 74 68 65 20 72 65 73 75 6c 74   ┆ng process and stores the result┆
0x420…440 20 69 6e 20 74 68 65 20 61 72 72 61 79 20 6f 66 0a 20 20 20 20 20 67 72 6f 75 70 20 49 44 73 20   ┆ in the array of      group IDs ┆
0x440…460 73 70 65 63 69 66 69 65 64 20 62 79 20 5f 08 67 5f 08 72 5f 08 6f 5f 08 75 5f 08 70 5f 08 6c 5f   ┆specified by _ g_ r_ o_ u_ p_ l_┆
0x460…480 08 69 5f 08 73 5f 08 74 2e 20 20 54 68 69 73 20 61 72 72 61 79 20 68 61 73 20 5f 08 67 5f 08 69   ┆ i_ s_ t.  This array has _ g_ i┆
0x480…4a0 5f 08 64 5f 08 73 5f 08 65 5f 08 74 5f 08 73 5f 08 69 5f 08 7a 5f 08 65 0a 20 20 20 20 20 65 6e   ┆_ d_ s_ e_ t_ s_ i_ z_ e      en┆
0x4a0…4c0 74 72 69 65 73 20 61 6e 64 20 6d 75 73 74 20 62 65 20 6c 61 72 67 65 20 65 6e 6f 75 67 68 20 74   ┆tries and must be large enough t┆
0x4c0…4e0 6f 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 65 6e 74 69 72 65 20 6c 69 73 74 2e 0a 20 20 20 20 20   ┆o contain the entire list.      ┆
0x4e0…500 54 68 69 73 20 6c 69 73 74 20 63 61 6e 6e 6f 74 20 62 65 20 67 72 65 61 74 65 72 20 74 68 61 6e   ┆This list cannot be greater than┆
0x500…520 20 7b 4e 47 4f 55 50 53 5f 4d 41 58 7d 2e 20 20 49 66 20 5f 08 67 5f 08 69 5f 08 64 5f 08 73 5f   ┆ {NGOUPS_MAX}.  If _ g_ i_ d_ s_┆
0x520…540 08 65 5f 08 74 5f 08 2d 0a 20 20 20 20 20 5f 08 73 5f 08 69 5f 08 7a 5f 08 65 20 65 71 75 61 6c   ┆ e_ t_ -      _ s_ i_ z_ e equal┆
0x540…560 73 20 30 2c 20 5f 08 67 5f 08 65 5f 08 74 5f 08 67 5f 08 72 5f 08 6f 5f 08 75 5f 08 70 5f 08 73   ┆s 0, _ g_ e_ t_ g_ r_ o_ u_ p_ s┆
0x560…580 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 67 72 6f 75 70   ┆ will return the number of group┆
0x580…5a0 73 20 74 6f 0a 20 20 20 20 20 77 68 69 63 68 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63   ┆s to      which the calling proc┆
0x5a0…5c0 65 73 73 20 62 65 6c 6f 6e 67 73 20 77 69 74 68 6f 75 74 20 6d 6f 64 69 66 79 69 6e 67 20 74 68   ┆ess belongs without modifying th┆
0x5c0…5e0 65 0a 20 20 20 20 20 61 72 72 61 79 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 5f 08 67 5f 08   ┆e      array pointed to by _ g_ ┆
0x5e0…600 72 5f 08 6f 5f 08 75 5f 08 70 5f 08 6c 5f 08 69 5f 08 73 5f 08 74 2e 0a 0a 52 08 52 08 52 08 52   ┆r_ o_ u_ p_ l_ i_ s_ t.  R R R R┆
0x600…620 45 08 45 08 45 08 45 54 08 54 08 54 08 54 55 08 55 08 55 08 55 52 08 52 08 52 08 52 4e 08 4e 08   ┆E E E ET T T TU U U UR R R RN N ┆
0x620…640 4e 08 4e 20 56 08 56 08 56 08 56 41 08 41 08 41 08 41 4c 08 4c 08 4c 08 4c 55 08 55 08 55 08 55   ┆N N V V V VA A A AL L L LU U U U┆
0x640…660 45 08 45 08 45 08 45 0a 20 20 20 20 20 55 70 6f 6e 20 73 75 63 63 65 73 73 66 75 6c 20 63 6f 6d   ┆E E E E      Upon successful com┆
0x660…680 70 6c 65 74 69 6f 6e 2c 20 5f 08 67 5f 08 65 5f 08 74 5f 08 67 5f 08 72 5f 08 6f 5f 08 75 5f 08   ┆pletion, _ g_ e_ t_ g_ r_ o_ u_ ┆
0x680…6a0 70 5f 08 73 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 20 20 20   ┆p_ s returns the number of      ┆
0x6a0…6c0 73 75 70 70 6c 65 6d 65 6e 74 61 72 79 20 67 72 6f 75 70 20 49 44 73 20 73 65 74 20 66 6f 72 20   ┆supplementary group IDs set for ┆
0x6c0…6e0 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 20 61 6e 64 0a 20 20 20 20 20 72 65 74   ┆the calling process and      ret┆
0x6e0…700 75 72 6e 73 20 74 68 65 20 76 61 6c 75 65 20 30 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 61 20   ┆urns the value 0.  Otherwise, a ┆
0x700…720 76 61 6c 75 65 20 6f 66 20 2d 31 20 69 73 20 72 65 74 75 72 6e 65 64 0a 20 20 20 20 20 61 6e 64   ┆value of -1 is returned      and┆
0x720…740 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e 5f 08 6f 20 69 73 20 73 65 74 20 74 6f 20 69 6e 64 69 63   ┆ _ e_ r_ r_ n_ o is set to indic┆
0x740…760 61 74 65 20 74 68 65 20 65 72 72 6f 72 2e 0a 0a 45 08 45 08 45 08 45 52 08 52 08 52 08 52 52 08   ┆ate the error.  E E E ER R R RR ┆
0x760…780 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 20 20 20   ┆R R RO O O OR R R RS S S S      ┆
0x780…7a0 5f 08 67 5f 08 65 5f 08 74 5f 08 67 5f 08 72 5f 08 6f 5f 08 75 5f 08 70 5f 08 73 20 77 69 6c 6c   ┆_ g_ e_ t_ g_ r_ o_ u_ p_ s will┆
0x7a0…7c0 20 66 61 69 6c 20 69 66 3a 0a 0a 20 20 20 20 20 5b 45 49 4e 56 41 4c 5d 20 20 20 20 20 20 20 54   ┆ fail if:       [EINVAL]       T┆
0x7c0…7e0 68 65 20 76 61 6c 75 65 20 6f 66 20 5f 08 67 5f 08 69 5f 08 64 5f 08 73 5f 08 65 5f 08 74 5f 08   ┆he value of _ g_ i_ d_ s_ e_ t_ ┆
0x7e0…800 73 5f 08 69 5f 08 7a 5f 08 65 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 20 61 6e 64 20 6c 65 73 73 0a   ┆s_ i_ z_ e is non-zero and less ┆
0x800…820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 61 6e 20 74 68 65 20 6e 75 6d   ┆                    than the num┆
0x820…840 62 65 72 20 6f 66 20 73 75 70 70 6c 65 6d 65 6e 74 61 72 79 20 67 72 6f 75 70 20 49 44 73 0a 20   ┆ber of supplementary group IDs  ┆
0x840…860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 65 74 20 66 6f 72 20 74 68 65 20 63   ┆                   set for the c┆
0x860…880 61 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45   ┆alling process.  S S S SE E E EE┆
0x880…8a0 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 4f 08 4f 08   ┆ E E E A A A AL L L LS S S SO O ┆
0x8a0…8c0 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 67 65 74 67 69   ┆O O      System Calls (2): getgi┆
0x8c0…8e0 64 28 29 2c 20 73 65 74 67 69 64 28 29 0a 0a 44 65 63 65 6d 62 65 72 20 31 39 39 30 20 20 20 20   ┆d(), setgid()  December 1990    ┆
0x8e0…900 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 61   ┆                       TX Progra┆
0x900…920 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 0a   ┆mmer's Reference                ┆
0x920…927 0a 0a 0a 0a 0a 0a 0a                                                                              ┆       ┆