DataMuseum.dk

top - download

    Length: 2178 (0x882)
    Names: »chroot.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./bsd/usr/man/cat2/chroot.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 20 20 20 63 68 72 6f 6f 74 28 32 29 0a 0a 0a 0a   ┆s                  chroot(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 63 68 72 6f 6f 74 20 2d 20 63 68 61 6e 67 65 20 72 6f 6f 74 20 64 69 72 65 63 74 6f 72 79   ┆  chroot - change root directory┆
0x0a0…0c0 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 54 41 08   ┆  S S S SY Y Y YN N N NT T T TA ┆
0x0c0…0e0 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 63 08 63 08 63 08 63 68 08 68 08 68 08 68   ┆A A AX X X X      c c c ch h h h┆
0x0e0…100 72 08 72 08 72 08 72 6f 08 6f 08 6f 08 6f 6f 08 6f 08 6f 08 6f 74 08 74 08 74 08 74 28 08 28 08   ┆r r r ro o o oo o o ot t t t( ( ┆
0x100…120 28 08 28 64 08 64 08 64 08 64 69 08 69 08 69 08 69 72 08 72 08 72 08 72 6e 08 6e 08 6e 08 6e 61   ┆( (d d d di i i ir r r rn n n na┆
0x120…140 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 29 08 29 08 29 08 29 0a 20 20 20 20   ┆ a a am m m me e e e) ) ) )     ┆
0x140…160 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 08   ┆ c c c ch h h ha a a ar r r r * ┆
0x160…180 2a 08 2a 08 2a 64 08 64 08 64 08 64 69 08 69 08 69 08 69 72 08 72 08 72 08 72 6e 08 6e 08 6e 08   ┆* * *d d d di i i ir r r rn n n ┆
0x180…1a0 6e 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 3b 08 3b 08 3b 08 3b 0a 0a 44   ┆na a a am m m me e e e; ; ; ;  D┆
0x1a0…1c0 08 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   ┆ D D DE E E ES S S SC C C CR R R┆
0x1c0…1e0 08 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   ┆ RI I I IP P P PT T T TI I I IO ┆
0x1e0…200 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 5f 08 44 5f 08 69 5f 08 72 5f 08 6e 5f 08   ┆O O ON N N N      _ D_ i_ r_ n_ ┆
0x200…220 61 5f 08 6d 5f 08 65 20 69 73 20 74 68 65 20 61 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 70 61   ┆a_ m_ e is the address of the pa┆
0x220…240 74 68 6e 61 6d 65 20 6f 66 20 61 20 64 69 72 65 63 74 6f 72 79 2c 20 74 65 72 2d 0a 20 20 20 20   ┆thname of a directory, ter-     ┆
0x240…260 20 6d 69 6e 61 74 65 64 20 62 79 20 61 20 6e 75 6c 6c 20 62 79 74 65 2e 20 20 5f 08 63 5f 08 68   ┆ minated by a null byte.  _ c_ h┆
0x260…280 5f 08 72 5f 08 6f 5f 08 6f 5f 08 74 20 63 61 75 73 65 73 20 74 68 69 73 20 64 69 72 65 63 74 6f   ┆_ r_ o_ o_ t causes this directo┆
0x280…2a0 72 79 20 74 6f 0a 20 20 20 20 20 62 65 63 6f 6d 65 20 74 68 65 20 72 6f 6f 74 20 64 69 72 65 63   ┆ry to      become the root direc┆
0x2a0…2c0 74 6f 72 79 2c 20 74 68 65 20 73 74 61 72 74 69 6e 67 20 70 6f 69 6e 74 20 66 6f 72 20 70 61 74   ┆tory, the starting point for pat┆
0x2c0…2e0 68 20 6e 61 6d 65 73 0a 20 20 20 20 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 60 20 2f 20   ┆h names      beginning with ` / ┆
0x2e0…300 27 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 6f 63 65 73 73 20 61 6e 64 20 61 6c   ┆' for the current process and al┆
0x300…320 6c 20 63 68 69 6c 2d 0a 20 20 20 20 20 64 72 65 6e 20 6f 66 20 74 68 69 73 20 70 72 6f 63 65 73   ┆l chil-      dren of this proces┆
0x320…340 73 2e 0a 0a 20 20 20 20 20 49 6e 20 6f 72 64 65 72 20 66 6f 72 20 61 20 64 69 72 65 63 74 6f 72   ┆s.       In order for a director┆
0x340…360 79 20 74 6f 20 62 65 63 6f 6d 65 20 74 68 65 20 72 6f 6f 74 20 64 69 72 65 63 74 6f 72 79 20 61   ┆y to become the root directory a┆
0x360…380 20 70 72 6f 2d 0a 20 20 20 20 20 63 65 73 73 20 6d 75 73 74 20 68 61 76 65 20 65 78 65 63 75 74   ┆ pro-      cess must have execut┆
0x380…3a0 65 20 28 73 65 61 72 63 68 29 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 64 69 72 65 63 74 6f   ┆e (search) access to the directo┆
0x3a0…3c0 72 79 2e 0a 0a 20 20 20 20 20 54 68 69 73 20 63 61 6c 6c 20 63 61 6e 20 62 65 20 75 73 65 64 20   ┆ry.       This call can be used ┆
0x3c0…3e0 6f 6e 6c 79 20 62 79 20 74 68 65 20 73 75 70 65 72 2d 75 73 65 72 2e 0a 0a 52 08 52 08 52 08 52   ┆only by the super-user.  R R R R┆
0x3e0…400 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 ┆
0x400…420 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┆
0x420…440 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┆
0x440…460 70 6c 65 74 69 6f 6e 2c 20 61 20 76 61 6c 75 65 20 6f 66 20 30 20 69 73 20 72 65 74 75 72 6e 65   ┆pletion, a value of 0 is returne┆
0x460…480 64 2e 20 20 4f 74 68 2d 0a 20 20 20 20 20 65 72 77 69 73 65 2c 20 61 20 76 61 6c 75 65 20 6f 66   ┆d.  Oth-      erwise, a value of┆
0x480…4a0 20 2d 31 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 5f 08 65 5f 08 72 5f 08 72 5f 08 6e   ┆ -1 is returned and _ e_ r_ r_ n┆
0x4a0…4c0 5f 08 6f 20 69 73 20 73 65 74 20 74 6f 20 69 6e 64 69 2d 0a 20 20 20 20 20 63 61 74 65 20 61 6e   ┆_ o is set to indi-      cate an┆
0x4c0…4e0 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 52 08 52 08 52 4f 08   ┆ error.  E E E ER R R RR R R RO ┆
0x4e0…500 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 5f 08 63 5f 08 68 5f   ┆O O OR R R RS S S S      _ c_ h_┆
0x500…520 08 72 5f 08 6f 5f 08 6f 5f 08 74 20 77 69 6c 6c 20 66 61 69 6c 20 61 6e 64 20 74 68 65 20 72 6f   ┆ r_ o_ o_ t will fail and the ro┆
0x520…540 6f 74 20 64 69 72 65 63 74 6f 72 79 20 77 69 6c 6c 20 62 65 20 75 6e 63 68 61 6e 67 65 64 20 69   ┆ot directory will be unchanged i┆
0x540…560 66 0a 20 20 20 20 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77   ┆f      one or more of the follow┆
0x560…580 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 0a 20 20 20 20 20 5b 45 41 43 43 45 53 5d 20 20 20 20   ┆ing are true:       [EACCES]    ┆
0x580…5a0 20 20 20 53 65 61 72 63 68 20 70 65 72 6d 69 73 73 69 6f 6e 20 69 73 20 64 65 6e 69 65 64 20 66   ┆   Search permission is denied f┆
0x5a0…5c0 6f 72 20 61 6e 79 20 63 6f 6d 70 6f 6e 65 6e 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆or any component                ┆
0x5c0…5e0 20 20 20 20 20 6f 66 20 74 68 65 20 70 61 74 68 20 6e 61 6d 65 2e 0a 0a 20 20 20 20 20 5b 45 46   ┆     of the path name.       [EF┆
0x5e0…600 41 55 4c 54 5d 20 20 20 20 20 20 20 5f 08 50 5f 08 61 5f 08 74 5f 08 68 20 70 6f 69 6e 74 73 20   ┆AULT]       _ P_ a_ t_ h points ┆
0x600…620 6f 75 74 73 69 64 65 20 74 68 65 20 70 72 6f 63 65 73 73 27 73 20 61 6c 6c 6f 63 61 74 65 64 0a   ┆outside the process's allocated ┆
0x620…640 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 64 64 72 65 73 73 20 73 70 61 63   ┆                    address spac┆
0x640…660 65 2e 0a 0a 20 20 20 20 20 5b 45 4c 4f 4f 50 5d 20 20 20 20 20 20 20 20 54 6f 6f 20 6d 61 6e 79   ┆e.       [ELOOP]        Too many┆
0x660…680 20 73 79 6d 62 6f 6c 69 63 20 6c 69 6e 6b 73 20 77 65 72 65 20 65 6e 63 6f 75 6e 74 65 72 65 64   ┆ symbolic links were encountered┆
0x680…6a0 20 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 6c 61 74   ┆ in                     translat┆
0x6a0…6c0 69 6e 67 20 74 68 65 20 70 61 74 68 6e 61 6d 65 2e 0a 0a 20 20 20 20 20 5b 45 4e 4f 45 4e 54 5d   ┆ing the pathname.       [ENOENT]┆
0x6c0…6e0 20 20 20 20 20 20 20 45 69 74 68 65 72 20 74 68 65 20 6e 61 6d 65 64 20 64 69 72 65 63 74 6f 72   ┆       Either the named director┆
0x6e0…700 79 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20   ┆y does not exist, or            ┆
0x700…720 20 20 20 20 20 20 20 20 20 74 68 65 20 70 61 74 68 6e 61 6d 65 20 77 61 73 20 74 6f 6f 20 6c 6f   ┆         the pathname was too lo┆
0x720…740 6e 67 2e 0a 0a 20 20 20 20 20 5b 45 4e 4f 54 44 49 52 5d 20 20 20 20 20 20 41 20 63 6f 6d 70 6f   ┆ng.       [ENOTDIR]      A compo┆
0x740…760 6e 65 6e 74 20 6f 66 20 74 68 65 20 70 61 74 68 20 6e 61 6d 65 20 69 73 20 6e 6f 74 20 61 20 64   ┆nent of the path name is not a d┆
0x760…780 69 72 65 63 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 72 79 2e 0a   ┆irec-                     tory. ┆
0x780…7a0 0a 20 20 20 20 20 5b 45 50 45 52 4d 5d 20 20 20 20 20 20 20 20 54 68 65 20 61 72 67 75 6d 65 6e   ┆      [EPERM]        The argumen┆
0x7a0…7c0 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 62 79 74 65 20 77 69 74 68 20 74 68 65 20 68 69 67 68 2d   ┆t contains a byte with the high-┆
0x7c0…7e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 72 64 65 72 20 62 69 74 20 73   ┆                     order bit s┆
0x7e0…800 65 74 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08 45 08 45 20 41 08 41 08 41   ┆et.  S S S SE E E EE E E E A A A┆
0x800…820 08 41 4c 08 4c 08 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20 53 79 73   ┆ AL L L LS S S SO O O O      Sys┆
0x820…840 74 65 6d 20 43 61 6c 6c 73 20 28 32 29 3a 20 20 63 68 64 69 72 0a 0a 4d 61 72 63 68 20 31 39 38   ┆tem Calls (2):  chdir  March 198┆
0x840…860 39 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 20 20 20 54   ┆9                              T┆
0x860…880 58 20 50 72 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   ┆X Programmer's Reference        ┆
0x880…882 0a 0a                                                                                             ┆  ┆