DataMuseum.dk

top - download

    Length: 6365 (0x18dd)
    Names: »execl.3«

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

Default Hex Dump

0x0000…0020 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_┆
0x0020…0040 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┆
0x0040…0060 69 6f 6e 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 78 65 63 6c 28 33 29 0a 0a 0a 0a   ┆ions                execl(3)    ┆
0x0060…0080 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    ┆
0x0080…00a0 20 20 65 78 65 63 2c 20 65 78 65 63 6c 2c 20 65 78 65 63 6c 70 2c 20 65 78 65 63 6c 65 2c 20 65   ┆  exec, execl, execlp, execle, e┆
0x00a0…00c0 78 65 63 76 2c 20 65 78 65 63 76 70 2c 20 65 78 65 63 76 65 2c 20 65 78 65 63 74 2c 0a 20 20 20   ┆xecv, execvp, execve, exect,    ┆
0x00c0…00e0 20 20 65 6e 76 69 72 6f 6e 20 2d 20 65 78 65 63 75 74 65 20 61 20 66 69 6c 65 0a 0a 53 08 53 08   ┆  environ - execute a file  S S ┆
0x00e0…0100 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 41 08 41 08 41 08 41 58   ┆S SY Y Y YN N N NT T T TA A A AX┆
0x0100…0120 08 58 08 58 08 58 0a 20 20 20 20 20 65 08 65 08 65 08 65 78 08 78 08 78 08 78 65 08 65 08 65 08   ┆ X X X      e e e ex x x xe e e ┆
0x0120…0140 65 63 08 63 08 63 08 63 6c 08 6c 08 6c 08 6c 28 08 28 08 28 08 28 6e 08 6e 08 6e 08 6e 61 08 61   ┆ec c c cl l l l( ( ( (n n n na a┆
0x0140…0160 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 2c 08 2c 08 2c 08 2c 20 61 08 61 08 61 08   ┆ a am m m me e e e, , , , a a a ┆
0x0160…0180 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 30 08 30 08 30 08 30 2c 08 2c 08 2c 08 2c 20 61 08   ┆ar r r rg g g g0 0 0 0, , , , a ┆
0x0180…01a0 61 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 31 08 31 08 31 08 31 2c 08 2c 08 2c 08   ┆a a ar r r rg g g g1 1 1 1, , , ┆
0x01a0…01c0 2c 20 2e 08 2e 08 2e 08 2e 2e 08 2e 08 2e 08 2e 2e 08 2e 08 2e 08 2e 2c 08 2c 08 2c 08 2c 20 61   ┆, . . . .. . . .. . . ., , , , a┆
0x01c0…01e0 08 61 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 6e 08 6e 08 6e 08 6e 2c 08 2c 08 2c   ┆ a a ar r r rg g g gn n n n, , ,┆
0x01e0…0200 08 2c 20 30 08 30 08 30 08 30 29 08 29 08 29 08 29 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08   ┆ , 0 0 0 0) ) ) )      c c c ch ┆
0x0200…0220 68 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 6e 08 6e 08 6e   ┆h h ha a a ar r r r * * * *n n n┆
0x0220…0240 08 6e 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 2c 08 2c 08 2c 08 2c 20 2a   ┆ na a a am m m me e e e, , , , *┆
0x0240…0260 08 2a 08 2a 08 2a 61 08 61 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 30 08 30 08 30   ┆ * * *a a a ar r r rg g g g0 0 0┆
0x0260…0280 08 30 2c 08 2c 08 2c 08 2c 20 2a 08 2a 08 2a 08 2a 61 08 61 08 61 08 61 72 08 72 08 72 08 72 67   ┆ 0, , , , * * * *a a a ar r r rg┆
0x0280…02a0 08 67 08 67 08 67 31 08 31 08 31 08 31 2c 08 2c 08 2c 08 2c 20 2e 08 2e 08 2e 08 2e 2e 08 2e 08   ┆ g g g1 1 1 1, , , , . . . .. . ┆
0x02a0…02c0 2e 08 2e 2e 08 2e 08 2e 08 2e 2c 08 2c 08 2c 08 2c 20 2a 08 2a 08 2a 08 2a 61 08 61 08 61 08 61   ┆. .. . . ., , , , * * * *a a a a┆
0x02c0…02e0 72 08 72 08 72 08 72 67 08 67 08 67 08 67 6e 08 6e 08 6e 08 6e 3b 08 3b 08 3b 08 3b 0a 0a 20 20   ┆r r r rg g g gn n n n; ; ; ;    ┆
0x02e0…0300 20 20 20 65 08 65 08 65 08 65 78 08 78 08 78 08 78 65 08 65 08 65 08 65 63 08 63 08 63 08 63 6c   ┆   e e e ex x x xe e e ec c c cl┆
0x0300…0320 08 6c 08 6c 08 6c 65 08 65 08 65 08 65 28 08 28 08 28 08 28 6e 08 6e 08 6e 08 6e 61 08 61 08 61   ┆ l l le e e e( ( ( (n n n na a a┆
0x0320…0340 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 2c 08 2c 08 2c 08 2c 20 61 08 61 08 61 08 61 72   ┆ am m m me e e e, , , , a a a ar┆
0x0340…0360 08 72 08 72 08 72 67 08 67 08 67 08 67 30 08 30 08 30 08 30 2c 08 2c 08 2c 08 2c 20 61 08 61 08   ┆ r r rg g g g0 0 0 0, , , , a a ┆
0x0360…0380 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 31 08 31 08 31 08 31 2c 08 2c 08 2c 08 2c 20   ┆a ar r r rg g g g1 1 1 1, , , , ┆
0x0380…03a0 2e 08 2e 08 2e 08 2e 2e 08 2e 08 2e 08 2e 2e 08 2e 08 2e 08 2e 2c 08 2c 08 2c 08 2c 20 61 08 61   ┆. . . .. . . .. . . ., , , , a a┆
0x03a0…03c0 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 6e 08 6e 08 6e 08 6e 2c 08 2c 08 2c 08 2c   ┆ a ar r r rg g g gn n n n, , , ,┆
0x03c0…03e0 20 30 08 30 08 30 08 30 2c 08 2c 08 2c 08 2c 20 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 76 08   ┆ 0 0 0 0, , , , e e e en n n nv ┆
0x03e0…0400 76 08 76 08 76 70 08 70 08 70 08 70 29 08 29 08 29 08 29 0a 20 20 20 20 20 63 08 63 08 63 08 63   ┆v v vp p p p) ) ) )      c c c c┆
0x0400…0420 68 08 68 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 6e 08 6e   ┆h h h ha a a ar r r r * * * *n n┆
0x0420…0440 08 6e 08 6e 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 2c 08 2c 08 2c 08 2c   ┆ n na a a am m m me e e e, , , ,┆
0x0440…0460 20 2a 08 2a 08 2a 08 2a 61 08 61 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 30 08 30   ┆ * * * *a a a ar r r rg g g g0 0┆
0x0460…0480 08 30 08 30 2c 08 2c 08 2c 08 2c 20 2a 08 2a 08 2a 08 2a 61 08 61 08 61 08 61 72 08 72 08 72 08   ┆ 0 0, , , , * * * *a a a ar r r ┆
0x0480…04a0 72 67 08 67 08 67 08 67 31 08 31 08 31 08 31 2c 08 2c 08 2c 08 2c 20 2e 08 2e 08 2e 08 2e 2e 08   ┆rg g g g1 1 1 1, , , , . . . .. ┆
0x04a0…04c0 2e 08 2e 08 2e 2e 08 2e 08 2e 08 2e 2c 08 2c 08 2c 08 2c 20 2a 08 2a 08 2a 08 2a 61 08 61 08 61   ┆. . .. . . ., , , , * * * *a a a┆
0x04c0…04e0 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 6e 08 6e 08 6e 08 6e 2c 08 2c 08 2c 08 2c 20 2a   ┆ ar r r rg g g gn n n n, , , , *┆
0x04e0…0500 08 2a 08 2a 08 2a 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 76 08 76 08 76 08 76 70 08 70 08 70   ┆ * * *e e e en n n nv v v vp p p┆
0x0500…0520 08 70 5b 08 5b 08 5b 08 5b 5d 08 5d 08 5d 08 5d 3b 08 3b 08 3b 08 3b 0a 0a 20 20 20 20 20 65 08   ┆ p[ [ [ [] ] ] ]; ; ; ;       e ┆
0x0520…0540 65 08 65 08 65 78 08 78 08 78 08 78 65 08 65 08 65 08 65 63 08 63 08 63 08 63 76 08 76 08 76 08   ┆e e ex x x xe e e ec c c cv v v ┆
0x0540…0560 76 28 08 28 08 28 08 28 6e 08 6e 08 6e 08 6e 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65   ┆v( ( ( (n n n na a a am m m me e┆
0x0560…0580 08 65 08 65 2c 08 2c 08 2c 08 2c 20 61 08 61 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08   ┆ e e, , , , a a a ar r r rg g g ┆
0x0580…05a0 67 76 08 76 08 76 08 76 29 08 29 08 29 08 29 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08 68 08   ┆gv v v v) ) ) )      c c c ch h ┆
0x05a0…05c0 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 6e 08 6e 08 6e 08 6e   ┆h ha a a ar r r r * * * *n n n n┆
0x05c0…05e0 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 2c 08 2c 08 2c 08 2c 20 2a 08 2a   ┆a a a am m m me e e e, , , , * *┆
0x05e0…0600 08 2a 08 2a 61 08 61 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 76 08 76 08 76 08 76   ┆ * *a a a ar r r rg g g gv v v v┆
0x0600…0620 5b 08 5b 08 5b 08 5b 5d 08 5d 08 5d 08 5d 3b 08 3b 08 3b 08 3b 0a 0a 20 20 20 20 20 65 08 65 08   ┆[ [ [ [] ] ] ]; ; ; ;       e e ┆
0x0620…0640 65 08 65 78 08 78 08 78 08 78 65 08 65 08 65 08 65 63 08 63 08 63 08 63 74 08 74 08 74 08 74 28   ┆e ex x x xe e e ec c c ct t t t(┆
0x0640…0660 08 28 08 28 08 28 6e 08 6e 08 6e 08 6e 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65   ┆ ( ( (n n n na a a am m m me e e┆
0x0660…0680 08 65 2c 08 2c 08 2c 08 2c 20 61 08 61 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 76   ┆ e, , , , a a a ar r r rg g g gv┆
0x0680…06a0 08 76 08 76 08 76 2c 08 2c 08 2c 08 2c 20 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 76 08 76 08   ┆ v v v, , , , e e e en n n nv v ┆
0x06a0…06c0 76 08 76 70 08 70 08 70 08 70 29 08 29 08 29 08 29 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08   ┆v vp p p p) ) ) )      c c c ch ┆
0x06c0…06e0 68 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 6e 08 6e 08 6e   ┆h h ha a a ar r r r * * * *n n n┆
0x06e0…0700 08 6e 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 2c 08 2c 08 2c 08 2c 20 2a   ┆ na a a am m m me e e e, , , , *┆
0x0700…0720 08 2a 08 2a 08 2a 61 08 61 08 61 08 61 72 08 72 08 72 08 72 67 08 67 08 67 08 67 76 08 76 08 76   ┆ * * *a a a ar r r rg g g gv v v┆
0x0720…0740 08 76 5b 08 5b 08 5b 08 5b 5d 08 5d 08 5d 08 5d 2c 08 2c 08 2c 08 2c 20 2a 08 2a 08 2a 08 2a 65   ┆ v[ [ [ [] ] ] ], , , , * * * *e┆
0x0740…0760 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 76 08 76 08 76 08 76 70 08 70 08 70 08 70 5b 08 5b 08 5b   ┆ e e en n n nv v v vp p p p[ [ [┆
0x0760…0780 08 5b 5d 08 5d 08 5d 08 5d 3b 08 3b 08 3b 08 3b 0a 0a 20 20 20 20 20 65 08 65 08 65 08 65 78 08   ┆ [] ] ] ]; ; ; ;       e e e ex ┆
0x0780…07a0 78 08 78 08 78 74 08 74 08 74 08 74 65 08 65 08 65 08 65 72 08 72 08 72 08 72 6e 08 6e 08 6e 08   ┆x x xt t t te e e er r r rn n n ┆
0x07a0…07c0 6e 20 63 08 63 08 63 08 63 68 08 68 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a   ┆n c c c ch h h ha a a ar r r r *┆
0x07c0…07e0 08 2a 08 2a 08 2a 2a 08 2a 08 2a 08 2a 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 76 08 76 08 76   ┆ * * ** * * *e e e en n n nv v v┆
0x07e0…0800 08 76 69 08 69 08 69 08 69 72 08 72 08 72 08 72 6f 08 6f 08 6f 08 6f 6e 08 6e 08 6e 08 6e 3b 08   ┆ vi i i ir r r ro o o on n n n; ┆
0x0800…0820 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 08   ┆; ; ;  D D D DE E E ES S S SC C ┆
0x0820…0840 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 49   ┆C CR R R RI I I IP P P PT T T TI┆
0x0840…0860 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 54 68 65 73 65 20   ┆ I I IO O O ON N N N      These ┆
0x0860…0880 72 6f 75 74 69 6e 65 73 20 70 72 6f 76 69 64 65 20 76 61 72 69 6f 75 73 20 69 6e 74 65 72 66 61   ┆routines provide various interfa┆
0x0880…08a0 63 65 73 20 74 6f 20 74 68 65 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 76 5f 08 65 20 73 79   ┆ces to the _ e_ x_ e_ c_ v_ e sy┆
0x08a0…08c0 73 2d 0a 20 20 20 20 20 74 65 6d 20 63 61 6c 6c 2e 20 20 52 65 66 65 72 20 74 6f 20 5f 08 65 5f   ┆s-      tem call.  Refer to _ e_┆
0x08c0…08e0 08 78 5f 08 65 5f 08 63 5f 08 76 5f 08 65 28 32 29 20 66 6f 72 20 61 20 64 65 73 63 72 69 70 74   ┆ x_ e_ c_ v_ e(2) for a descript┆
0x08e0…0900 69 6f 6e 20 6f 66 20 74 68 65 69 72 0a 20 20 20 20 20 70 72 6f 70 65 72 74 69 65 73 3b 20 6f 6e   ┆ion of their      properties; on┆
0x0900…0920 6c 79 20 62 72 69 65 66 20 64 65 73 63 72 69 70 74 69 6f 6e 73 20 61 72 65 20 70 72 6f 76 69 64   ┆ly brief descriptions are provid┆
0x0920…0940 65 64 20 68 65 72 65 2e 0a 0a 20 20 20 20 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 20 69 6e 20 61   ┆ed here.       _ e_ x_ e_ c in a┆
0x0940…0960 6c 6c 20 69 74 73 20 66 6f 72 6d 73 20 6f 76 65 72 6c 61 79 73 20 74 68 65 20 63 61 6c 6c 69 6e   ┆ll its forms overlays the callin┆
0x0960…0980 67 20 70 72 6f 63 65 73 73 20 77 69 74 68 20 74 68 65 0a 20 20 20 20 20 6e 61 6d 65 64 20 66 69   ┆g process with the      named fi┆
0x0980…09a0 6c 65 2c 20 74 68 65 6e 20 74 72 61 6e 73 66 65 72 73 20 74 6f 20 74 68 65 20 65 6e 74 72 79 20   ┆le, then transfers to the entry ┆
0x09a0…09c0 70 6f 69 6e 74 20 6f 66 20 74 68 65 20 63 6f 72 65 0a 20 20 20 20 20 69 6d 61 67 65 20 6f 66 20   ┆point of the core      image of ┆
0x09c0…09e0 74 68 65 20 66 69 6c 65 2e 20 20 54 68 65 72 65 20 63 61 6e 20 62 65 20 6e 6f 20 72 65 74 75 72   ┆the file.  There can be no retur┆
0x09e0…0a00 6e 20 66 72 6f 6d 20 61 20 73 75 63 63 65 73 73 66 75 6c 0a 20 20 20 20 20 5f 08 65 5f 08 78 5f   ┆n from a successful      _ e_ x_┆
0x0a00…0a20 08 65 5f 08 63 3b 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 63 6f 72 65 20 69 6d 61 67 65 20 69 73   ┆ e_ c; the calling core image is┆
0x0a20…0a40 20 6c 6f 73 74 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 20 61 72   ┆ lost.       The _ n_ a_ m_ e ar┆
0x0a40…0a60 67 75 6d 65 6e 74 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6e 61 6d 65 20   ┆gument is a pointer to the name ┆
0x0a60…0a80 6f 66 20 74 68 65 20 66 69 6c 65 20 74 6f 20 62 65 0a 20 20 20 20 20 65 78 65 63 75 74 65 64 2e   ┆of the file to be      executed.┆
0x0a80…0aa0 20 20 54 68 65 20 70 6f 69 6e 74 65 72 73 20 5f 08 61 5f 08 72 5f 08 67 5b 5f 08 30 5d 2c 20 5f   ┆  The pointers _ a_ r_ g[_ 0], _┆
0x0aa0…0ac0 08 61 5f 08 72 5f 08 67 5b 5f 08 31 5d 20 2e 2e 2e 20 20 61 64 64 72 65 73 73 20 6e 75 6c 6c 2d   ┆ a_ r_ g[_ 1] ...  address null-┆
0x0ac0…0ae0 0a 20 20 20 20 20 74 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69 6e 67 73 2e 20 20 42 79 20 63 6f   ┆      terminated strings.  By co┆
0x0ae0…0b00 6e 76 65 6e 74 69 6f 6e 2c 20 5f 08 61 5f 08 72 5f 08 67 5b 5f 08 30 5d 20 69 73 20 74 68 65 20   ┆nvention, _ a_ r_ g[_ 0] is the ┆
0x0b00…0b20 6e 61 6d 65 20 6f 66 0a 20 20 20 20 20 74 68 65 20 66 69 6c 65 2e 0a 0a 20 20 20 20 20 54 77 6f   ┆name of      the file.       Two┆
0x0b20…0b40 20 69 6e 74 65 72 66 61 63 65 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e 20 20 5f 08 65 5f   ┆ interfaces are available.  _ e_┆
0x0b40…0b60 08 78 5f 08 65 5f 08 63 5f 08 6c 20 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20 61 20 6b 6e 6f   ┆ x_ e_ c_ l is useful when a kno┆
0x0b60…0b80 77 6e 0a 20 20 20 20 20 66 69 6c 65 20 77 69 74 68 20 6b 6e 6f 77 6e 20 61 72 67 75 6d 65 6e 74   ┆wn      file with known argument┆
0x0b80…0ba0 73 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 3b 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73   ┆s is being called; the arguments┆
0x0ba0…0bc0 20 74 6f 0a 20 20 20 20 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 6c 20 61 72 65 20 74 68 65   ┆ to      _ e_ x_ e_ c_ l are the┆
0x0bc0…0be0 20 63 68 61 72 61 63 74 65 72 20 73 74 72 69 6e 67 73 20 63 6f 6e 73 74 69 74 75 74 69 6e 67 20   ┆ character strings constituting ┆
0x0be0…0c00 74 68 65 20 66 69 6c 65 20 61 6e 64 0a 20 20 20 20 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 3b   ┆the file and      the arguments;┆
0x0c00…0c20 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 63 6f 6e 76 65 6e 74 69 6f   ┆ the first argument is conventio┆
0x0c20…0c40 6e 61 6c 6c 79 20 74 68 65 20 73 61 6d 65 0a 20 20 20 20 20 61 73 20 74 68 65 20 66 69 6c 65 20   ┆nally the same      as the file ┆
0x0c40…0c60 6e 61 6d 65 20 28 6f 72 20 69 74 73 20 6c 61 73 74 20 63 6f 6d 70 6f 6e 65 6e 74 29 2e 20 20 41   ┆name (or its last component).  A┆
0x0c60…0c80 20 30 20 61 72 67 75 6d 65 6e 74 20 6d 75 73 74 0a 20 20 20 20 20 65 6e 64 20 74 68 65 20 61 72   ┆ 0 argument must      end the ar┆
0x0c80…0ca0 67 75 6d 65 6e 74 20 6c 69 73 74 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 65 5f 08 78 5f 08 65   ┆gument list.       The _ e_ x_ e┆
0x0ca0…0cc0 5f 08 63 5f 08 76 20 76 65 72 73 69 6f 6e 20 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20 74 68   ┆_ c_ v version is useful when th┆
0x0cc0…0ce0 65 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 69 73 0a 20 20 20 20 20 75 6e   ┆e number of arguments is      un┆
0x0ce0…0d00 6b 6e 6f 77 6e 20 69 6e 20 61 64 76 61 6e 63 65 3b 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 20   ┆known in advance; the arguments ┆
0x0d00…0d20 74 6f 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 76 20 61 72 65 20 74 68 65 20 6e 61 6d 65 20   ┆to _ e_ x_ e_ c_ v are the name ┆
0x0d20…0d40 6f 66 0a 20 20 20 20 20 74 68 65 20 66 69 6c 65 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20   ┆of      the file to be executed ┆
0x0d40…0d60 61 6e 64 20 61 20 76 65 63 74 6f 72 20 6f 66 20 73 74 72 69 6e 67 73 20 63 6f 6e 74 61 69 6e 69   ┆and a vector of strings containi┆
0x0d60…0d80 6e 67 0a 20 20 20 20 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 20 6c 61 73 74   ┆ng      the arguments.  The last┆
0x0d80…0da0 20 61 72 67 75 6d 65 6e 74 20 73 74 72 69 6e 67 20 6d 75 73 74 20 62 65 20 66 6f 6c 6c 6f 77 65   ┆ argument string must be followe┆
0x0da0…0dc0 64 20 62 79 0a 20 20 20 20 20 61 20 30 20 70 6f 69 6e 74 65 72 2e 0a 0a 20 20 20 20 20 57 68 65   ┆d by      a 0 pointer.       Whe┆
0x0dc0…0de0 6e 20 61 20 43 20 70 72 6f 67 72 61 6d 20 69 73 20 65 78 65 63 75 74 65 64 2c 20 69 74 20 69 73   ┆n a C program is executed, it is┆
0x0de0…0e00 20 63 61 6c 6c 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 20 20 20 20 20 20 20 20 6d   ┆ called as follows:            m┆
0x0e00…0e20 61 69 6e 28 61 72 67 63 2c 20 61 72 67 76 2c 20 65 6e 76 70 29 0a 20 20 20 20 20 20 20 20 20 20   ┆ain(argc, argv, envp)           ┆
0x0e20…0e40 69 6e 74 20 61 72 67 63 3b 0a 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 2a 61 72 67 76 2c   ┆int argc;           char **argv,┆
0x0e40…0e60 20 2a 2a 65 6e 76 70 3b 0a 0a 20 20 20 20 20 77 68 65 72 65 20 5f 08 61 5f 08 72 5f 08 67 5f 08   ┆ **envp;       where _ a_ r_ g_ ┆
0x0e60…0e80 63 20 69 73 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 63 6f 75 6e 74 20 61 6e 64 20 5f 08 61 5f   ┆c is the argument count and _ a_┆
0x0e80…0ea0 08 72 5f 08 67 5f 08 76 20 69 73 20 61 6e 20 61 72 72 61 79 20 6f 66 0a 20 20 20 20 20 63 68 61   ┆ r_ g_ v is an array of      cha┆
0x0ea0…0ec0 72 61 63 74 65 72 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73   ┆racter pointers to the arguments┆
0x0ec0…0ee0 20 74 68 65 6d 73 65 6c 76 65 73 2e 20 20 41 73 20 69 6e 64 69 2d 0a 20 20 20 20 20 63 61 74 65   ┆ themselves.  As indi-      cate┆
0x0ee0…0f00 64 2c 20 5f 08 61 5f 08 72 5f 08 67 5f 08 63 20 69 73 20 63 6f 6e 76 65 6e 74 69 6f 6e 61 6c 6c   ┆d, _ a_ r_ g_ c is conventionall┆
0x0f00…0f20 79 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 61 6e 64 20 74 68 65 20 66 69 72 73 74 0a 20 20 20   ┆y at least one and the first    ┆
0x0f20…0f40 20 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 20 61 72 72 61 79 20 70 6f 69 6e 74 73 20 74 6f 20   ┆  member of the array points to ┆
0x0f40…0f60 61 20 73 74 72 69 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 6e 61 6d 65 0a 20 20 20   ┆a string containing the name    ┆
0x0f60…0f80 20 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 0a 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 5f 08 41 5f 08   ┆  of the file.             _ A_ ┆
0x0f80…0fa0 72 5f 08 67 5f 08 76 20 69 73 20 64 69 72 65 63 74 6c 79 20 75 73 61 62 6c 65 20 69 6e 20 61 6e   ┆r_ g_ v is directly usable in an┆
0x0fa0…0fc0 6f 74 68 65 72 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 76 20 62 65 63 61 75 73 65 20 5f 08   ┆other _ e_ x_ e_ c_ v because _ ┆
0x0fc0…0fe0 61 5f 08 72 5f 08 67 5f 08 76 5b 5f 08 61 5f 08 72 5f 08 67 5f 08 63 5d 0a 20 20 20 20 20 69 73   ┆a_ r_ g_ v[_ a_ r_ g_ c]      is┆
0x0fe0…1000 20 30 2e 0a 0a 20 20 20 20 20 5f 08 65 5f 08 6e 5f 08 76 5f 08 70 20 69 73 20 61 20 70 6f 69 6e   ┆ 0.       _ e_ n_ v_ p is a poin┆
0x1000…1020 74 65 72 20 74 6f 20 61 6e 20 61 72 72 61 79 20 6f 66 20 73 74 72 69 6e 67 73 20 74 68 61 74 20   ┆ter to an array of strings that ┆
0x1020…1040 63 6f 6e 73 74 69 74 75 74 65 20 74 68 65 0a 20 20 20 20 20 5f 08 65 5f 08 6e 5f 08 76 5f 08 69   ┆constitute the      _ e_ n_ v_ i┆
0x1040…1060 5f 08 72 5f 08 6f 5f 08 6e 5f 08 6d 5f 08 65 5f 08 6e 5f 08 74 20 6f 66 20 74 68 65 20 70 72 6f   ┆_ r_ o_ n_ m_ e_ n_ t of the pro┆
0x1060…1080 63 65 73 73 2e 20 20 45 61 63 68 20 73 74 72 69 6e 67 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61   ┆cess.  Each string consists of a┆
0x1080…10a0 20 6e 61 6d 65 2c 0a 20 20 20 20 20 61 6e 20 22 3d 22 2c 20 61 6e 64 20 61 20 6e 75 6c 6c 2d 74   ┆ name,      an "=", and a null-t┆
0x10a0…10c0 65 72 6d 69 6e 61 74 65 64 20 76 61 6c 75 65 2e 20 20 54 68 65 20 61 72 72 61 79 20 6f 66 20 70   ┆erminated value.  The array of p┆
0x10c0…10e0 6f 69 6e 74 65 72 73 0a 20 20 20 20 20 69 73 20 74 65 72 6d 69 6e 61 74 65 64 20 62 79 20 61 20   ┆ointers      is terminated by a ┆
0x10e0…1100 6e 75 6c 6c 20 70 6f 69 6e 74 65 72 2e 20 20 54 68 65 20 73 68 65 6c 6c 20 5f 08 73 5f 08 68 28   ┆null pointer.  The shell _ s_ h(┆
0x1100…1120 31 29 20 70 61 73 73 65 73 20 61 6e 0a 20 20 20 20 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 65 6e   ┆1) passes an      environment en┆
0x1120…1140 74 72 79 20 66 6f 72 20 65 61 63 68 20 67 6c 6f 62 61 6c 20 73 68 65 6c 6c 20 76 61 72 69 61 62   ┆try for each global shell variab┆
0x1140…1160 6c 65 20 64 65 66 69 6e 65 64 0a 20 20 20 20 20 77 68 65 6e 20 74 68 65 20 70 72 6f 67 72 61 6d   ┆le defined      when the program┆
0x1160…1180 20 69 73 20 63 61 6c 6c 65 64 2e 20 20 53 65 65 20 5f 08 65 5f 08 6e 5f 08 76 5f 08 69 5f 08 72   ┆ is called.  See _ e_ n_ v_ i_ r┆
0x1180…11a0 5f 08 6f 5f 08 6e 28 37 29 20 66 6f 72 20 73 6f 6d 65 20 63 6f 6e 76 65 6e 2d 0a 20 20 20 20 20   ┆_ o_ n(7) for some conven-      ┆
0x11a0…11c0 74 69 6f 6e 61 6c 6c 79 20 75 73 65 64 20 6e 61 6d 65 73 2e 20 20 54 68 65 20 43 20 72 75 6e 2d   ┆tionally used names.  The C run-┆
0x11c0…11e0 74 69 6d 65 20 73 74 61 72 74 2d 6f 66 66 20 72 6f 75 74 69 6e 65 0a 20 20 20 20 20 70 6c 61 63   ┆time start-off routine      plac┆
0x11e0…1200 65 73 20 61 20 63 6f 70 79 20 6f 66 20 5f 08 65 5f 08 6e 5f 08 76 5f 08 70 20 69 6e 20 74 68 65   ┆es a copy of _ e_ n_ v_ p in the┆
0x1200…1220 20 67 6c 6f 62 61 6c 20 63 65 6c 6c 20 5f 08 65 5f 08 6e 5f 08 76 5f 08 69 5f 08 72 5f 08 6f 5f   ┆ global cell _ e_ n_ v_ i_ r_ o_┆
0x1220…1240 08 6e 2c 20 77 68 69 63 68 20 69 73 0a 20 20 20 20 20 75 73 65 64 20 62 79 20 5f 08 65 5f 08 78   ┆ n, which is      used by _ e_ x┆
0x1240…1260 5f 08 65 5f 08 63 5f 08 76 20 61 6e 64 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 6c 20 74 6f   ┆_ e_ c_ v and _ e_ x_ e_ c_ l to┆
0x1260…1280 20 70 61 73 73 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 74 6f 20 61 6e 79 20 73 75 62   ┆ pass the environment to any sub┆
0x1280…12a0 2d 0a 20 20 20 20 20 70 72 6f 67 72 61 6d 73 20 65 78 65 63 75 74 65 64 20 62 79 20 74 68 65 20   ┆-      programs executed by the ┆
0x12a0…12c0 63 75 72 72 65 6e 74 20 70 72 6f 67 72 61 6d 2e 0a 0a 20 20 20 20 20 5f 08 65 5f 08 78 5f 08 65   ┆current program.       _ e_ x_ e┆
0x12c0…12e0 5f 08 63 5f 08 6c 5f 08 70 20 61 6e 64 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 76 5f 08 70   ┆_ c_ l_ p and _ e_ x_ e_ c_ v_ p┆
0x12e0…1300 20 61 72 65 20 63 61 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 61 72 67 75 6d 65   ┆ are called with the same argume┆
0x1300…1320 6e 74 73 20 61 73 0a 20 20 20 20 20 5f 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 6c 20 61 6e 64 20   ┆nts as      _ e_ x_ e_ c_ l and ┆
0x1320…1340 5f 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 76 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2c 20 62   ┆_ e_ x_ e_ c_ v, respectively, b┆
0x1340…1360 75 74 20 64 75 70 6c 69 63 61 74 65 20 74 68 65 20 73 68 65 6c 6c 27 73 0a 20 20 20 20 20 61 63   ┆ut duplicate the shell's      ac┆
0x1360…1380 74 69 6f 6e 73 20 69 6e 20 73 65 61 72 63 68 69 6e 67 20 66 6f 72 20 61 6e 20 65 78 65 63 75 74   ┆tions in searching for an execut┆
0x1380…13a0 61 62 6c 65 20 66 69 6c 65 20 69 6e 20 61 20 6c 69 73 74 20 6f 66 0a 20 20 20 20 20 64 69 72 65   ┆able file in a list of      dire┆
0x13a0…13c0 63 74 6f 72 69 65 73 2e 20 20 54 68 65 20 64 69 72 65 63 74 6f 72 79 20 6c 69 73 74 20 69 73 20   ┆ctories.  The directory list is ┆
0x13c0…13e0 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 0a 20 20 20 20 20 65 6e 76 69 72 6f 6e 6d 65   ┆obtained from the      environme┆
0x13e0…1400 6e 74 2e 0a 0a 46 08 46 08 46 08 46 49 08 49 08 49 08 49 4c 08 4c 08 4c 08 4c 45 08 45 08 45 08   ┆nt.  F F F FI I I IL L L LE E E ┆
0x1400…1420 45 53 08 53 08 53 08 53 0a 20 20 20 20 20 2f 62 69 6e 2f 73 68 20 20 73 68 65 6c 6c 2c 20 69 6e   ┆ES S S S      /bin/sh  shell, in┆
0x1420…1440 76 6f 6b 65 64 20 69 66 20 63 6f 6d 6d 61 6e 64 20 66 69 6c 65 20 66 6f 75 6e 64 20 62 79 20 5f   ┆voked if command file found by _┆
0x1440…1460 08 65 5f 08 78 5f 08 65 5f 08 63 5f 08 6c 5f 08 70 20 6f 72 0a 20 20 20 20 20 5f 08 65 5f 08 78   ┆ e_ x_ e_ c_ l_ p or      _ e_ x┆
0x1460…1480 5f 08 65 5f 08 63 5f 08 76 5f 08 70 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08   ┆_ e_ c_ v_ p  S S S SE E E EE E ┆
0x1480…14a0 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┆
0x14a0…14c0 0a 20 20 20 20 20 55 73 65 72 20 43 6f 6d 6d 61 6e 64 73 20 28 31 29 3a 20 20 63 73 68 0a 20 20   ┆      User Commands (1):  csh   ┆
0x14c0…14e0 20 20 20 53 79 73 74 65 6d 20 43 61 6c 6c 73 20 28 32 29 3a 20 20 65 78 65 63 76 65 2c 20 66 6f   ┆   System Calls (2):  execve, fo┆
0x14e0…1500 72 6b 0a 20 20 20 20 20 41 70 70 65 6e 64 69 78 65 73 20 28 37 29 3a 20 20 65 6e 76 69 72 6f 6e   ┆rk      Appendixes (7):  environ┆
0x1500…1520 0a 0a 44 08 44 08 44 08 44 49 08 49 08 49 08 49 41 08 41 08 41 08 41 47 08 47 08 47 08 47 4e 08   ┆  D D D DI I I IA A A AG G G GN ┆
0x1520…1540 4e 08 4e 08 4e 4f 08 4f 08 4f 08 4f 53 08 53 08 53 08 53 54 08 54 08 54 08 54 49 08 49 08 49 08   ┆N N NO O O OS S S ST T T TI I I ┆
0x1540…1560 49 43 08 43 08 43 08 43 53 08 53 08 53 08 53 0a 20 20 20 20 20 49 66 20 74 68 65 20 66 69 6c 65   ┆IC C C CS S S S      If the file┆
0x1560…1580 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2c 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 65   ┆ cannot be found, if it is not e┆
0x1580…15a0 78 65 63 75 74 61 62 6c 65 2c 20 69 66 20 69 74 0a 20 20 20 20 20 64 6f 65 73 20 6e 6f 74 20 73   ┆xecutable, if it      does not s┆
0x15a0…15c0 74 61 72 74 20 77 69 74 68 20 61 20 76 61 6c 69 64 20 6d 61 67 69 63 20 6e 75 6d 62 65 72 20 28   ┆tart with a valid magic number (┆
0x15c0…15e0 73 65 65 20 61 2e 6f 75 74 20 66 69 6c 65 0a 20 20 20 20 20 66 6f 72 6d 61 74 29 2c 20 69 66 20   ┆see a.out file      format), if ┆
0x15e0…1600 6d 61 78 69 6d 75 6d 20 6d 65 6d 6f 72 79 20 69 73 20 65 78 63 65 65 64 65 64 2c 20 6f 72 20 69   ┆maximum memory is exceeded, or i┆
0x1600…1620 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 0a 20 20 20 20 20 72 65 71 75 69 72 65 20 74 6f 6f   ┆f the arguments      require too┆
0x1620…1640 20 6d 75 63 68 20 73 70 61 63 65 2c 20 61 20 72 65 74 75 72 6e 20 63 6f 6e 73 74 69 74 75 74 65   ┆ much space, a return constitute┆
0x1640…1660 73 20 74 68 65 20 64 69 61 67 6e 6f 73 74 69 63 3b 0a 20 20 20 20 20 74 68 65 20 72 65 74 75 72   ┆s the diagnostic;      the retur┆
0x1660…1680 6e 20 76 61 6c 75 65 20 69 73 20 2d 31 2e 20 20 45 76 65 6e 20 66 6f 72 20 74 68 65 20 73 75 70   ┆n value is -1.  Even for the sup┆
0x1680…16a0 65 72 2d 75 73 65 72 2c 20 61 74 20 6c 65 61 73 74 0a 20 20 20 20 20 6f 6e 65 20 6f 66 20 74 68   ┆er-user, at least      one of th┆
0x16a0…16c0 65 20 65 78 65 63 75 74 65 2d 70 65 72 6d 69 73 73 69 6f 6e 20 62 69 74 73 20 6d 75 73 74 20 62   ┆e execute-permission bits must b┆
0x16c0…16e0 65 20 73 65 74 20 66 6f 72 20 61 20 66 69 6c 65 20 74 6f 0a 20 20 20 20 20 62 65 20 65 78 65 63   ┆e set for a file to      be exec┆
0x16e0…1700 75 74 65 64 2e 0a 0a 4c 08 4c 08 4c 08 4c 49 08 49 08 49 08 49 4d 08 4d 08 4d 08 4d 49 08 49 08   ┆uted.  L L L LI I I IM M M MI I ┆
0x1700…1720 49 08 49 54 08 54 08 54 08 54 41 08 41 08 41 08 41 54 08 54 08 54 08 54 49 08 49 08 49 08 49 4f   ┆I IT T T TA A A AT T T TI I I IO┆
0x1720…1740 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 53 08 53 08 53 08 53 0a 20 20 20 20 20 49 66 20 5f 08 65   ┆ O O ON N N NS S S S      If _ e┆
0x1740…1760 5f 08 78 5f 08 65 5f 08 63 5f 08 76 5f 08 70 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 65 78 65   ┆_ x_ e_ c_ v_ p is called to exe┆
0x1760…1780 63 75 74 65 20 61 20 66 69 6c 65 20 74 68 61 74 20 74 75 72 6e 73 20 6f 75 74 20 74 6f 20 62 65   ┆cute a file that turns out to be┆
0x1780…17a0 20 61 0a 20 20 20 20 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 66 69 6c 65 2c 20 61 6e 64 20   ┆ a      shell command file, and ┆
0x17a0…17c0 69 66 20 69 74 20 69 73 20 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f 20 65 78 65 63 75 74 65 20 74   ┆if it is impossible to execute t┆
0x17c0…17e0 68 65 0a 20 20 20 20 20 73 68 65 6c 6c 2c 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 5f 08 61   ┆he      shell, the values of _ a┆
0x17e0…1800 5f 08 72 5f 08 67 5f 08 76 5b 5f 08 30 5d 20 61 6e 64 20 5f 08 61 5f 08 72 5f 08 67 5f 08 76 5b   ┆_ r_ g_ v[_ 0] and _ a_ r_ g_ v[┆
0x1800…1820 2d 5f 08 31 5d 20 77 69 6c 6c 20 62 65 20 6d 6f 64 69 66 69 65 64 0a 20 20 20 20 20 62 65 66 6f   ┆-_ 1] will be modified      befo┆
0x1820…1840 72 65 20 72 65 74 75 72 6e 2e 0a 0a 20 20 20 20 20 4e 08 4e 08 4e 08 4e 4f 08 4f 08 4f 08 4f 54   ┆re return.       N N N NO O O OT┆
0x1840…1860 08 54 08 54 08 54 45 08 45 08 45 08 45 2e 08 2e 08 2e 08 2e 20 54 68 65 20 5f 08 65 5f 08 78 5f   ┆ T T TE E E E. . . . The _ e_ x_┆
0x1860…1880 08 65 5f 08 63 5f 08 74 20 76 65 72 73 69 6f 6e 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 6e 6f   ┆ e_ c_ t version is currently no┆
0x1880…18a0 74 20 73 75 70 70 6f 72 74 65 64 2e 0a 0a 4d 61 72 63 68 20 31 39 38 39 20 20 20 20 20 20 20 20   ┆t supported.  March 1989        ┆
0x18a0…18c0 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 6d   ┆                      TX Program┆
0x18c0…18dd 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            ┆mer's Reference              ┆