DataMuseum.dk

top - download

    Length: 2463 (0x99f)
    Names: »putenv.3«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat3/putenv.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 67 65 74 65 6e 76 28 33 29 0a 0a 0a 0a   ┆ions               getenv(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 70 75 74 65 6e 76 20 2d 20 63 68 61 6e 67 65 20 6f 72 20 61 64 64 20 76 61 6c 75 65 20 74   ┆  putenv - change or add value t┆
0x0a0…0c0 6f 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e   ┆o environment  S S S SY Y Y YN N┆
0x0c0…0e0 08 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   ┆ N NO O O OP P P PS S S SI I I I┆
0x0e0…100 53 08 53 08 53 08 53 0a 20 20 20 20 20 23 08 23 08 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e   ┆S S S S      # # # #i i i in n n┆
0x100…120 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 64 65 08   ┆ nc c c cl l l lu u u ud d d de ┆
0x120…140 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08 73 08 73 08 73 74 08 74 08 74 08 74 64 08 64 08 64   ┆e e e < < < <s s s st t t td d d┆
0x140…160 08 64 6c 08 6c 08 6c 08 6c 69 08 69 08 69 08 69 62 08 62 08 62 08 62 2e 08 2e 08 2e 08 2e 68 08   ┆ dl l l li i i ib b b b. . . .h ┆
0x160…180 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 6e 08 6e 08   ┆h h h> > > >       i i i in n n ┆
0x180…1a0 6e 74 08 74 08 74 08 74 20 70 08 70 08 70 08 70 75 08 75 08 75 08 75 74 08 74 08 74 08 74 65 08   ┆nt t t t p p p pu u u ut t t te ┆
0x1a0…1c0 65 08 65 08 65 6e 08 6e 08 6e 08 6e 76 08 76 08 76 08 76 28 08 28 08 28 08 28 73 08 73 08 73 08   ┆e e en n n nv v v v( ( ( (s s s ┆
0x1c0…1e0 73 74 08 74 08 74 08 74 72 08 72 08 72 08 72 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 67 08 67   ┆st t t tr r r ri i i in n n ng g┆
0x1e0…200 08 67 08 67 29 08 29 08 29 08 29 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08 68 08 68 08 68 61   ┆ g g) ) ) )      c c c ch h h ha┆
0x200…220 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 73 08 73 08 73 08 73 74 08 74 08   ┆ a a ar r r r * * * *s s s st t ┆
0x220…240 74 08 74 72 08 72 08 72 08 72 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 67 08 67 08 67 08 67 3b   ┆t tr r r ri i i in n n ng g g g;┆
0x240…260 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 08 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43   ┆ ; ; ;  D D D DE E E ES S S SC C┆
0x260…280 08 43 08 43 52 08 52 08 52 08 52 49 08 49 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54   ┆ C CR R R RI I I IP P P PT T T T┆
0x280…2a0 49 08 49 08 49 08 49 4f 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 5f 08 73 5f 08   ┆I I I IO O O ON N N N      _ s_ ┆
0x2a0…2c0 74 5f 08 72 5f 08 69 5f 08 6e 5f 08 67 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74 72 69 6e 67   ┆t_ r_ i_ n_ g points to a string┆
0x2c0…2e0 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 60 60 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 3d 5f 08 76 5f   ┆ of the form ``_ n_ a_ m_ e=_ v_┆
0x2e0…300 08 61 5f 08 6c 5f 08 75 5f 08 65 2e 27 27 20 5f 08 70 5f 08 75 5f 08 74 5f 08 65 5f 08 6e 5f 08   ┆ a_ l_ u_ e.'' _ p_ u_ t_ e_ n_ ┆
0x300…320 76 0a 20 20 20 20 20 6d 61 6b 65 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 65 6e   ┆v      makes the value of the en┆
0x320…340 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 20   ┆vironment variable _ n_ a_ m_ e ┆
0x340…360 65 71 75 61 6c 20 74 6f 0a 20 20 20 20 20 5f 08 76 5f 08 61 5f 08 6c 5f 08 75 5f 08 65 20 62 79   ┆equal to      _ v_ a_ l_ u_ e by┆
0x360…380 20 61 6c 74 65 72 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67 20 76 61 72 69 61 62 6c 65 20 6f   ┆ altering an existing variable o┆
0x380…3a0 72 20 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 0a 20 20 20 20 20 6f 6e 65 2e 20 20 49 6e 20 65   ┆r creating a new      one.  In e┆
0x3a0…3c0 69 74 68 65 72 20 63 61 73 65 2c 20 74 68 65 20 73 74 72 69 6e 67 20 70 6f 69 6e 74 65 64 20 74   ┆ither case, the string pointed t┆
0x3c0…3e0 6f 20 62 79 20 5f 08 73 5f 08 74 5f 08 72 5f 08 69 5f 08 6e 5f 08 67 0a 20 20 20 20 20 62 65 63   ┆o by _ s_ t_ r_ i_ n_ g      bec┆
0x3e0…400 6f 6d 65 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2c 20 73 6f   ┆omes part of the environment, so┆
0x400…420 20 61 6c 74 65 72 69 6e 67 20 74 68 65 20 73 74 72 69 6e 67 20 77 69 6c 6c 0a 20 20 20 20 20 63   ┆ altering the string will      c┆
0x420…440 68 61 6e 67 65 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20 20 54 68 65 20 73 70 61 63   ┆hange the environment.  The spac┆
0x440…460 65 20 75 73 65 64 20 62 79 20 5f 08 73 5f 08 74 5f 08 72 5f 08 69 5f 08 6e 5f 08 67 20 69 73 20   ┆e used by _ s_ t_ r_ i_ n_ g is ┆
0x460…480 6e 6f 0a 20 20 20 20 20 6c 6f 6e 67 65 72 20 75 73 65 64 20 6f 6e 63 65 20 61 20 6e 65 77 20 73   ┆no      longer used once a new s┆
0x480…4a0 74 72 69 6e 67 2d 64 65 66 69 6e 69 6e 67 20 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 20 69 73 20 70   ┆tring-defining _ n_ a_ m_ e is p┆
0x4a0…4c0 61 73 73 65 64 20 74 6f 0a 20 20 20 20 20 5f 08 70 5f 08 75 5f 08 74 5f 08 65 5f 08 6e 5f 08 76   ┆assed to      _ p_ u_ t_ e_ n_ v┆
0x4c0…4e0 2e 20 20 42 65 63 61 75 73 65 20 6f 66 20 74 68 69 73 20 6c 69 6d 69 74 61 74 69 6f 6e 2c 20 5f   ┆.  Because of this limitation, _┆
0x4e0…500 08 73 5f 08 74 5f 08 72 5f 08 69 5f 08 6e 5f 08 67 20 73 68 6f 75 6c 64 20 62 65 0a 20 20 20 20   ┆ s_ t_ r_ i_ n_ g should be     ┆
0x500…520 20 64 65 63 6c 61 72 65 64 20 73 74 61 74 69 63 20 69 66 20 69 74 20 69 73 20 64 65 63 6c 61 72   ┆ declared static if it is declar┆
0x520…540 65 64 20 77 69 74 68 69 6e 20 61 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 53 08 53 08 53 08 53 45 08   ┆ed within a function.  S S S SE ┆
0x540…560 45 08 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   ┆E E EE E E E A A A AL L L LS S S┆
0x560…580 08 53 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   ┆ SO O O O      System Calls (2):┆
0x580…5a0 20 65 78 65 63 0a 20 20 20 20 20 4c 69 62 72 61 72 79 20 46 75 6e 63 74 69 6f 6e 73 20 28 33 29   ┆ exec      Library Functions (3)┆
0x5a0…5c0 3a 20 67 65 74 65 6e 76 2c 20 73 65 74 65 6e 76 2c 20 75 6e 73 65 74 65 6e 76 0a 0a 52 08 52 08   ┆: getenv, setenv, unsetenv  R R ┆
0x5c0…5e0 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 08 52 08 52 08 52 4e   ┆R RE E E ET T T TU U U UR R R RN┆
0x5e0…600 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 4c 08 4c 55 08 55 08   ┆ N N N V V V VA A A AL L L LU U ┆
0x600…620 55 08 55 45 08 45 08 45 08 45 0a 20 20 20 20 20 5f 08 70 5f 08 75 5f 08 74 5f 08 65 5f 08 6e 5f   ┆U UE E E E      _ p_ u_ t_ e_ n_┆
0x620…640 08 76 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 20 69 66 20 69 74 20 77 61 73 20 75 6e   ┆ v returns non-zero if it was un┆
0x640…660 61 62 6c 65 20 74 6f 20 6f 62 74 61 69 6e 20 65 6e 6f 75 67 68 0a 20 20 20 20 20 73 70 61 63 65   ┆able to obtain enough      space┆
0x660…680 20 76 69 61 20 5f 08 6d 5f 08 61 5f 08 6c 5f 08 6c 5f 08 6f 5f 08 63 20 66 6f 72 20 61 6e 20 65   ┆ via _ m_ a_ l_ l_ o_ c for an e┆
0x680…6a0 78 70 61 6e 64 65 64 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2c 20 6f 74 68 65 72 77 69 73 65 0a 20   ┆xpanded environment, otherwise  ┆
0x6a0…6c0 20 20 20 20 7a 65 72 6f 2e 0a 0a 4e 08 4e 08 4e 08 4e 4f 08 4f 08 4f 08 4f 54 08 54 08 54 08 54   ┆    zero.  N N N NO O O OT T T T┆
0x6c0…6e0 45 08 45 08 45 08 45 53 08 53 08 53 08 53 0a 20 20 20 20 20 5f 08 70 5f 08 75 5f 08 74 5f 08 65   ┆E E E ES S S S      _ p_ u_ t_ e┆
0x6e0…700 5f 08 6e 5f 08 76 20 6d 61 6e 69 70 75 6c 61 74 65 73 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65   ┆_ n_ v manipulates the environme┆
0x700…720 6e 74 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 5f 08 65 5f 08 6e 5f 08 76 5f 08 69 5f 08 72   ┆nt pointed to by _ e_ n_ v_ i_ r┆
0x720…740 5f 08 6f 5f 08 6e 2c 0a 20 20 20 20 20 61 6e 64 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20   ┆_ o_ n,      and can be used in ┆
0x740…760 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 5f 08 67 5f 08 65 5f 08 74 5f 08 65 5f 08 6e   ┆conjunction with _ g_ e_ t_ e_ n┆
0x760…780 5f 08 76 2e 20 20 48 6f 77 65 76 65 72 2c 20 5f 08 65 5f 08 6e 5f 08 76 5f 08 70 0a 20 20 20 20   ┆_ v.  However, _ e_ n_ v_ p     ┆
0x780…7a0 20 28 74 68 65 20 74 68 69 72 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 5f 08 6d 5f 08 61 5f 08   ┆ (the third argument to _ m_ a_ ┆
0x7a0…7c0 69 5f 08 6e 29 20 69 73 20 6e 6f 74 20 63 68 61 6e 67 65 64 2e 0a 0a 20 20 20 20 20 54 68 69 73   ┆i_ n) is not changed.       This┆
0x7c0…7e0 20 72 6f 75 74 69 6e 65 20 75 73 65 73 20 5f 08 6d 5f 08 61 5f 08 6c 5f 08 6c 5f 08 6f 5f 08 63   ┆ routine uses _ m_ a_ l_ l_ o_ c┆
0x7e0…800 20 74 6f 20 65 6e 6c 61 72 67 65 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 0a 0a 20 20   ┆ to enlarge the environment.    ┆
0x800…820 20 20 20 41 66 74 65 72 20 5f 08 70 5f 08 75 5f 08 74 5f 08 65 5f 08 6e 5f 08 76 20 69 73 20 63   ┆   After _ p_ u_ t_ e_ n_ v is c┆
0x820…840 61 6c 6c 65 64 2c 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 61 6c 20 76 61 72 69 61 62 6c 65 73 20 61   ┆alled, environmental variables a┆
0x840…860 72 65 20 6e 6f 74 20 69 6e 0a 20 20 20 20 20 61 6c 70 68 61 62 65 74 69 63 61 6c 20 6f 72 64 65   ┆re not in      alphabetical orde┆
0x860…880 72 2e 0a 0a 20 20 20 20 20 41 20 70 6f 74 65 6e 74 69 61 6c 20 65 72 72 6f 72 20 69 73 20 74 6f   ┆r.       A potential error is to┆
0x880…8a0 20 63 61 6c 6c 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 5f 08 70 5f 08 75 5f 08 74 5f 08 65 5f   ┆ call the function _ p_ u_ t_ e_┆
0x8a0…8c0 08 6e 5f 08 76 20 77 69 74 68 20 61 0a 20 20 20 20 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20   ┆ n_ v with a      pointer to an ┆
0x8c0…8e0 61 75 74 6f 6d 61 74 69 63 20 76 61 72 69 61 62 6c 65 20 61 73 20 74 68 65 20 61 72 67 75 6d 65   ┆automatic variable as the argume┆
0x8e0…900 6e 74 20 61 6e 64 20 74 6f 20 74 68 65 6e 0a 20 20 20 20 20 65 78 69 74 20 74 68 65 20 63 61 6c   ┆nt and to then      exit the cal┆
0x900…920 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 77 68 69 6c 65 20 5f 08 73 5f 08 74 5f 08 72 5f 08 69   ┆ling function while _ s_ t_ r_ i┆
0x920…940 5f 08 6e 5f 08 67 20 69 73 20 73 74 69 6c 6c 20 70 61 72 74 20 6f 66 20 74 68 65 0a 20 20 20 20   ┆_ n_ g is still part of the     ┆
0x940…960 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 0a 0a 44 65 63 65 6d 62 65 72 20 31 39 39 30 20 20 20 20   ┆ environment.  December 1990    ┆
0x960…980 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┆
0x980…99f 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      ┆mmer's Reference               ┆