DataMuseum.dk

top - download

    Length: 2504 (0x9c8)
    Names: »rename.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./bsd/usr/man/cat2/rename.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 72 65 6e 61 6d 65 28 32 29 0a 0a 0a 0a   ┆s                  rename(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 72 65 6e 61 6d 65 20 2d 20 63 68 61 6e 67 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20   ┆  rename - change the name of a ┆
0x0a0…0c0 66 69 6c 65 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   ┆file  S S S SY Y Y YN N N NT T T┆
0x0c0…0e0 08 54 41 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 72 08 72 08 72 08 72 65 08 65   ┆ TA A A AX X X X      r r r re e┆
0x0e0…100 08 65 08 65 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 08 65   ┆ e en n n na a a am m m me e e e┆
0x100…120 28 08 28 08 28 08 28 66 08 66 08 66 08 66 72 08 72 08 72 08 72 6f 08 6f 08 6f 08 6f 6d 08 6d 08   ┆( ( ( (f f f fr r r ro o o om m ┆
0x120…140 6d 08 6d 2c 08 2c 08 2c 08 2c 20 74 08 74 08 74 08 74 6f 08 6f 08 6f 08 6f 29 08 29 08 29 08 29   ┆m m, , , , t t t to o o o) ) ) )┆
0x140…160 0a 20 20 20 20 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   ┆      c c c ch h h ha a a ar r r┆
0x160…180 08 72 20 2a 08 2a 08 2a 08 2a 66 08 66 08 66 08 66 72 08 72 08 72 08 72 6f 08 6f 08 6f 08 6f 6d   ┆ r * * * *f f f fr r r ro o o om┆
0x180…1a0 08 6d 08 6d 08 6d 2c 08 2c 08 2c 08 2c 20 2a 08 2a 08 2a 08 2a 74 08 74 08 74 08 74 6f 08 6f 08   ┆ m m m, , , , * * * *t t t to o ┆
0x1a0…1c0 6f 08 6f 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 53 08 53 08   ┆o o; ; ; ;  D D D DE E E ES S S ┆
0x1c0…1e0 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 50 54 08 54   ┆SC C C CR R R RI I I IP P P PT T┆
0x1e0…200 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 20 20 20 5f   ┆ T TI I I IO O O ON N N N      _┆
0x200…220 08 72 5f 08 65 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 20 63 61 75 73 65 73 20 74 68 65 20 6c 69 6e   ┆ r_ e_ n_ a_ m_ e causes the lin┆
0x220…240 6b 20 6e 61 6d 65 64 20 5f 08 66 5f 08 72 5f 08 6f 5f 08 6d 20 74 6f 20 62 65 20 72 65 6e 61 6d   ┆k named _ f_ r_ o_ m to be renam┆
0x240…260 65 64 20 61 73 20 5f 08 74 5f 08 6f 2e 20 20 49 66 0a 20 20 20 20 20 5f 08 74 5f 08 6f 20 65 78   ┆ed as _ t_ o.  If      _ t_ o ex┆
0x260…280 69 73 74 73 2c 20 74 68 65 6e 20 69 74 20 69 73 20 66 69 72 73 74 20 72 65 6d 6f 76 65 64 2e 20   ┆ists, then it is first removed. ┆
0x280…2a0 20 42 6f 74 68 20 5f 08 66 5f 08 72 5f 08 6f 5f 08 6d 20 61 6e 64 20 5f 08 74 5f 08 6f 20 6d 75   ┆ Both _ f_ r_ o_ m and _ t_ o mu┆
0x2a0…2c0 73 74 0a 20 20 20 20 20 62 65 20 6f 66 20 74 68 65 20 73 61 6d 65 20 74 79 70 65 20 28 74 68 61   ┆st      be of the same type (tha┆
0x2c0…2e0 74 20 69 73 2c 20 62 6f 74 68 20 64 69 72 65 63 74 6f 72 69 65 73 20 6f 72 20 62 6f 74 68 20 6e   ┆t is, both directories or both n┆
0x2e0…300 6f 6e 2d 0a 20 20 20 20 20 64 69 72 65 63 74 6f 72 69 65 73 29 2c 20 61 6e 64 20 6d 75 73 74 20   ┆on-      directories), and must ┆
0x300…320 72 65 73 69 64 65 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 66 69 6c 65 20 73 79 73 74 65 6d 2e 0a   ┆reside on the same file system. ┆
0x320…340 0a 20 20 20 20 20 5f 08 72 5f 08 65 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 20 67 75 61 72 61 6e 74   ┆      _ r_ e_ n_ a_ m_ e guarant┆
0x340…360 65 65 73 20 74 68 61 74 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 5f 08 74 5f 08 6f 20 61   ┆ees that an instance of _ t_ o a┆
0x360…380 6c 77 61 79 73 20 65 78 69 73 74 73 2c 20 61 6e 64 0a 20 20 20 20 20 74 68 65 20 69 6e 73 74 61   ┆lways exists, and      the insta┆
0x380…3a0 6e 63 65 20 6f 66 20 5f 08 66 5f 08 72 5f 08 6f 5f 08 6d 20 69 73 20 61 6c 77 61 79 73 20 64 65   ┆nce of _ f_ r_ o_ m is always de┆
0x3a0…3c0 6c 65 74 65 64 2c 20 65 76 65 6e 20 69 66 20 74 68 65 20 73 79 73 74 65 6d 0a 20 20 20 20 20 73   ┆leted, even if the system      s┆
0x3c0…3e0 68 6f 75 6c 64 20 63 72 61 73 68 20 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 20 6f 66 20 74 68 65   ┆hould crash in the middle of the┆
0x3e0…400 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08 45 08 45 54 08 54 08 54   ┆ operation.  R R R RE E E ET T T┆
0x400…420 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 41   ┆ TU U U UR R R RN N N N V V V VA┆
0x420…440 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 20   ┆ A A AL L L LU U U UE E E E     ┆
0x440…460 20 41 20 30 20 76 61 6c 75 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20 6f 70   ┆ A 0 value is returned if the op┆
0x460…480 65 72 61 74 69 6f 6e 20 73 75 63 63 65 65 64 73 2c 20 6f 74 68 65 72 77 69 73 65 0a 20 20 20 20   ┆eration succeeds, otherwise     ┆
0x480…4a0 20 5f 08 72 5f 08 65 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 20 72 65 74 75 72 6e 73 20 2d 31 20 61   ┆ _ r_ e_ n_ a_ m_ e returns -1 a┆
0x4a0…4c0 6e 64 20 74 68 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   ┆nd the global variable _ e_ r_ r┆
0x4c0…4e0 5f 08 6e 5f 08 6f 20 69 6e 64 69 63 61 74 65 73 0a 20 20 20 20 20 74 68 65 20 72 65 61 73 6f 6e   ┆_ n_ o indicates      the reason┆
0x4e0…500 20 66 6f 72 20 74 68 65 20 66 61 69 6c 75 72 65 2e 0a 0a 45 08 45 08 45 08 45 52 08 52 08 52 08   ┆ for the failure.  E E E ER R R ┆
0x500…520 52 52 08 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   ┆RR R R RO O O OR R R RS S S S   ┆
0x520…540 20 20 20 5f 08 72 5f 08 65 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 20 66 61 69 6c 73 20 61 6e 64 20   ┆   _ r_ e_ n_ a_ m_ e fails and ┆
0x540…560 62 6f 74 68 20 6f 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 66 69 6c 65 73 20 72 65 6d 61 69   ┆both of the argument files remai┆
0x560…580 6e 20 75 6e 63 68 61 6e 67 65 64 0a 20 20 20 20 20 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20 66   ┆n unchanged      if any of the f┆
0x580…5a0 6f 6c 6c 6f 77 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   ┆ollowing are true:       [EACCES┆
0x5a0…5c0 5d 20 20 20 20 20 20 20 45 69 74 68 65 72 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 6c 69 6e   ┆]       Either the requested lin┆
0x5c0…5e0 6b 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20   ┆k does not have the             ┆
0x5e0…600 20 20 20 20 20 20 20 20 72 65 71 75 69 72 65 64 20 77 72 69 74 65 20 70 65 72 6d 69 73 73 69 6f   ┆        required write permissio┆
0x600…620 6e 20 66 6f 72 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 2c 0a 20 20 20 20 20 20 20 20 20 20 20   ┆n for the directory,            ┆
0x620…640 20 20 20 20 20 20 20 20 20 6f 72 20 61 20 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66 20 65 69 74 68 65   ┆         or a component of eithe┆
0x640…660 72 20 70 61 74 68 20 70 72 65 66 69 78 20 64 65 6e 69 65 73 0a 20 20 20 20 20 20 20 20 20 20 20   ┆r path prefix denies            ┆
0x660…680 20 20 20 20 20 20 20 20 20 73 65 61 72 63 68 20 70 65 72 6d 69 73 73 69 6f 6e 2e 0a 0a 20 20 20   ┆         search permission.     ┆
0x680…6a0 20 20 5b 45 46 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   ┆  [EFAULT]       _ P_ a_ t_ h po┆
0x6a0…6c0 69 6e 74 73 20 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   ┆ints outside the process's alloc┆
0x6c0…6e0 61 74 65 64 0a 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   ┆ated                     address┆
0x6e0…700 20 73 70 61 63 65 2e 0a 0a 20 20 20 20 20 5b 45 49 4e 56 41 4c 5d 20 20 20 20 20 20 20 5f 08 46   ┆ space.       [EINVAL]       _ F┆
0x700…720 5f 08 72 5f 08 6f 5f 08 6d 20 69 73 20 61 20 70 61 72 65 6e 74 20 64 69 72 65 63 74 6f 72 79 20   ┆_ r_ o_ m is a parent directory ┆
0x720…740 6f 66 20 5f 08 74 5f 08 6f 2e 0a 0a 20 20 20 20 20 5b 45 4e 4f 45 4e 54 5d 20 20 20 20 20 20 20   ┆of _ t_ o.       [ENOENT]       ┆
0x740…760 45 69 74 68 65 72 20 61 20 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66 20 65 69 74 68 65 72 20 70 61 74   ┆Either a component of either pat┆
0x760…780 68 20 70 72 65 66 69 78 20 64 6f 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆h prefix does                   ┆
0x780…7a0 20 20 6e 6f 74 20 65 78 69 73 74 2c 20 6f 72 20 74 68 65 20 66 69 6c 65 20 6e 61 6d 65 64 20 62   ┆  not exist, or the file named b┆
0x7a0…7c0 79 20 5f 08 66 5f 08 72 5f 08 6f 5f 08 6d 20 64 6f 65 73 20 6e 6f 74 0a 20 20 20 20 20 20 20 20   ┆y _ f_ r_ o_ m does not         ┆
0x7c0…7e0 20 20 20 20 20 20 20 20 20 20 20 20 65 78 69 73 74 2e 0a 0a 20 20 20 20 20 5b 45 4e 4f 54 44 49   ┆            exist.       [ENOTDI┆
0x7e0…800 52 5d 20 20 20 20 20 20 41 20 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66 20 65 69 74 68 65 72 20 70 61   ┆R]      A component of either pa┆
0x800…820 74 68 20 70 72 65 66 69 78 20 69 73 20 6e 6f 74 20 61 0a 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆th prefix is not a              ┆
0x820…840 20 20 20 20 20 20 20 64 69 72 65 63 74 6f 72 79 2e 0a 0a 20 20 20 20 20 5b 45 52 4f 46 53 5d 20   ┆       directory.       [EROFS] ┆
0x840…860 20 20 20 20 20 20 20 54 68 65 20 72 65 71 75 65 73 74 65 64 20 6c 69 6e 6b 20 72 65 71 75 69 72   ┆       The requested link requir┆
0x860…880 65 73 20 77 72 69 74 69 6e 67 20 69 6e 20 61 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆es writing in a                 ┆
0x880…8a0 20 20 20 20 64 69 72 65 63 74 6f 72 79 20 6f 6e 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 66 69 6c   ┆    directory on a read-only fil┆
0x8a0…8c0 65 20 73 79 73 74 65 6d 2e 0a 0a 20 20 20 20 20 5b 45 58 44 45 56 5d 20 20 20 20 20 20 20 20 54   ┆e system.       [EXDEV]        T┆
0x8c0…8e0 68 65 20 6c 69 6e 6b 20 6e 61 6d 65 64 20 62 79 20 5f 08 74 5f 08 6f 20 61 6e 64 20 74 68 65 20   ┆he link named by _ t_ o and the ┆
0x8e0…900 66 69 6c 65 20 6e 61 6d 65 64 20 62 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆file named by                   ┆
0x900…920 20 20 5f 08 66 5f 08 72 5f 08 6f 5f 08 6d 20 61 72 65 20 6f 6e 20 64 69 66 66 65 72 65 6e 74 20   ┆  _ f_ r_ o_ m are on different ┆
0x920…940 66 69 6c 65 20 73 79 73 74 65 6d 73 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45   ┆file systems.  S S S SE E E EE E┆
0x940…960 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 4f 08   ┆ E E A A A AL L L LS S S SO O O ┆
0x960…980 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 6f 70 65 6e 0a 0a   ┆O      System Calls (2):  open  ┆
0x980…9a0 4d 61 72 63 68 20 31 39 38 39 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆March 1989                      ┆
0x9a0…9c0 20 20 20 20 20 20 20 20 54 58 20 50 72 6f 67 72 61 6d 6d 65 72 27 73 20 52 65 66 65 72 65 6e 63   ┆        TX Programmer's Referenc┆
0x9c0…9c8 65 0a 0a 0a 0a 0a 0a 0a                                                                           ┆e       ┆