DataMuseum.dk

top - download

    Length: 2844 (0xb1c)
    Names: »unlink.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./bsd/usr/man/cat2/unlink.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 75 6e 6c 69 6e 6b 28 32 29 0a 0a 0a 0a   ┆s                  unlink(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 75 6e 6c 69 6e 6b 20 2d 20 72 65 6d 6f 76 65 20 64 69 72 65 63 74 6f 72 79 20 65 6e 74 72   ┆  unlink - remove directory entr┆
0x0a0…0c0 79 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   ┆y  S S S SY Y Y YN N N NT T T TA┆
0x0c0…0e0 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 75 08 75 08 75 08 75 6e 08 6e 08 6e 08   ┆ A A AX X X X      u u u un n n ┆
0x0e0…100 6e 6c 08 6c 08 6c 08 6c 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 6b 08 6b 08 6b 08 6b 28 08 28   ┆nl l l li i i in n n nk k k k( (┆
0x100…120 08 28 08 28 70 08 70 08 70 08 70 61 08 61 08 61 08 61 74 08 74 08 74 08 74 68 08 68 08 68 08 68   ┆ ( (p p p pa a a at t t th h h h┆
0x120…140 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 08 61 08 61   ┆) ) ) )      c c c ch h h ha a a┆
0x140…160 08 61 72 08 72 08 72 08 72 20 2a 08 2a 08 2a 08 2a 70 08 70 08 70 08 70 61 08 61 08 61 08 61 74   ┆ ar r r r * * * *p p p pa a a at┆
0x160…180 08 74 08 74 08 74 68 08 68 08 68 08 68 3b 08 3b 08 3b 08 3b 0a 0a 44 08 44 08 44 08 44 45 08 45   ┆ t t th h h h; ; ; ;  D D D DE E┆
0x180…1a0 08 45 08 45 53 08 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   ┆ E ES S S SC C C CR R R RI I I I┆
0x1a0…1c0 50 08 50 08 50 08 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   ┆P P P PT T T TI I I IO O O ON N ┆
0x1c0…1e0 4e 08 4e 0a 20 20 20 20 20 5f 08 75 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 6b 20 72 65 6d 6f   ┆N N      _ u_ n_ l_ i_ n_ k remo┆
0x1e0…200 76 65 73 20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 66 69 6c 65 20 5f 08 70 5f 08   ┆ves the entry for the file _ p_ ┆
0x200…220 61 5f 08 74 5f 08 68 20 66 72 6f 6d 20 74 68 65 20 66 69 6e 61 6c 0a 20 20 20 20 20 64 69 72 65   ┆a_ t_ h from the final      dire┆
0x220…240 63 74 6f 72 79 20 69 6e 20 74 68 61 74 20 5f 08 70 5f 08 61 5f 08 74 5f 08 68 2e 20 20 52 65 73   ┆ctory in that _ p_ a_ t_ h.  Res┆
0x240…260 6f 75 72 63 65 20 72 65 63 6c 61 6d 61 74 69 6f 6e 20 64 65 70 65 6e 64 73 20 6f 6e 0a 20 20 20   ┆ource reclamation depends on    ┆
0x260…280 20 20 62 6f 74 68 20 77 68 65 74 68 65 72 20 74 68 65 72 65 20 69 73 20 6f 6e 6c 79 20 6f 6e 65   ┆  both whether there is only one┆
0x280…2a0 20 68 61 72 64 20 6c 69 6e 6b 20 74 6f 20 74 68 65 20 66 69 6c 65 20 6f 72 20 6e 6f 74 2c 0a 20   ┆ hard link to the file or not,  ┆
0x2a0…2c0 20 20 20 20 61 6e 64 20 77 68 65 74 68 65 72 20 61 6e 79 20 70 72 6f 63 65 73 73 20 68 61 73 20   ┆    and whether any process has ┆
0x2c0…2e0 74 68 65 20 66 69 6c 65 20 6f 70 65 6e 20 6f 72 20 6e 6f 74 2e 20 20 54 68 65 20 66 6f 6c 2d 0a   ┆the file open or not.  The fol- ┆
0x2e0…300 20 20 20 20 20 6c 6f 77 69 6e 67 20 63 61 73 65 73 20 61 72 65 20 70 6f 73 73 69 62 6c 65 2e 0a   ┆     lowing cases are possible. ┆
0x300…320 0a 20 20 20 20 20 31 29 20 20 20 49 66 20 6e 6f 20 70 72 6f 63 65 73 73 20 68 61 73 20 74 68 65   ┆      1)   If no process has the┆
0x320…340 20 66 69 6c 65 20 6f 70 65 6e 20 61 6e 64 20 74 68 69 73 20 69 73 20 74 68 65 20 6c 61 73 74 0a   ┆ file open and this is the last ┆
0x340…360 20 20 20 20 20 20 20 20 20 20 68 61 72 64 20 6c 69 6e 6b 20 74 6f 20 74 68 65 20 66 69 6c 65 2c   ┆          hard link to the file,┆
0x360…380 20 74 68 65 6e 20 61 6c 6c 20 72 65 73 6f 75 72 63 65 73 20 61 73 73 6f 63 69 61 74 65 64 0a 20   ┆ then all resources associated  ┆
0x380…3a0 20 20 20 20 20 20 20 20 20 77 69 74 68 20 74 68 65 20 66 69 6c 65 20 61 72 65 20 72 65 63 6c 61   ┆         with the file are recla┆
0x3a0…3c0 69 6d 65 64 2e 0a 0a 20 20 20 20 20 32 29 20 20 20 49 66 20 74 68 65 20 66 69 6c 65 20 77 61 73   ┆imed.       2)   If the file was┆
0x3c0…3e0 20 6f 70 65 6e 20 69 6e 20 61 6e 79 20 70 72 6f 63 65 73 73 2c 20 61 6e 64 20 74 68 69 73 20 69   ┆ open in any process, and this i┆
0x3e0…400 73 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 6c 61 73 74 20 68 61 72 64 20 6c 69 6e 6b 20 74   ┆s the           last hard link t┆
0x400…420 6f 20 74 68 65 20 66 69 6c 65 2c 20 74 68 65 20 61 63 74 75 61 6c 20 72 65 73 6f 75 72 63 65 20   ┆o the file, the actual resource ┆
0x420…440 72 65 63 6c 61 2d 0a 20 20 20 20 20 20 20 20 20 20 6d 61 74 69 6f 6e 20 69 73 20 64 65 6c 61 79   ┆recla-           mation is delay┆
0x440…460 65 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 6c 65 20 69 73 20 63 6c 6f 73 65 64 20 28 65 76 65   ┆ed until the file is closed (eve┆
0x460…480 6e 20 74 68 6f 75 67 68 0a 20 20 20 20 20 20 20 20 20 20 74 68 65 20 64 69 72 65 63 74 6f 72 79   ┆n though           the directory┆
0x480…4a0 20 65 6e 74 72 79 20 77 69 6c 6c 20 62 65 20 72 65 6d 6f 76 65 64 29 2e 0a 0a 20 20 20 20 20 33   ┆ entry will be removed).       3┆
0x4a0…4c0 29 20 20 20 49 66 20 74 68 69 73 20 77 61 73 20 6e 6f 74 20 74 68 65 20 6c 61 73 74 20 68 61 72   ┆)   If this was not the last har┆
0x4c0…4e0 64 20 6c 69 6e 6b 20 74 6f 20 74 68 65 20 66 69 6c 65 2c 20 6f 6e 6c 79 0a 20 20 20 20 20 20 20   ┆d link to the file, only        ┆
0x4e0…500 20 20 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 65 6e 74 72 79 20 69 73 20 72 65 6d 6f 76 65   ┆   the directory entry is remove┆
0x500…520 64 2e 20 20 4e 6f 20 72 65 73 6f 75 72 63 65 20 72 65 63 6c 61 6d 61 2d 0a 20 20 20 20 20 20 20   ┆d.  No resource reclama-        ┆
0x520…540 20 20 20 74 69 6f 6e 20 69 73 20 64 6f 6e 65 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08 45 08 45   ┆   tion is done.  R R R RE E E E┆
0x540…560 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 4e 08 4e 20 56 08 56   ┆T T T TU U U UR R R RN N N N V V┆
0x560…580 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 45 08 45 08 45 08 45   ┆ V VA A A AL L L LU U U UE E E E┆
0x580…5a0 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 70 6c 65 74 69 6f 6e   ┆      Upon successful completion┆
0x5a0…5c0 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 64 2e 20 20 4f 74 68   ┆, a value of 0 is returned.  Oth┆
0x5c0…5e0 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 20 2d 31 20 69 73 20   ┆-      erwise, a value of -1 is ┆
0x5e0…600 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 5f 08 6f 20 69 73 20   ┆returned and _ e_ r_ r_ n_ o is ┆
0x600…620 73 65 74 20 74 6f 20 69 6e 64 69 2d 0a 20 20 20 20 20 63 61 74 65 20 74 68 65 20 65 72 72 6f 72   ┆set to indi-      cate the error┆
0x620…640 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 4f 08 4f 08 4f 52   ┆.  E E E ER R R RR R R RO O O OR┆
0x640…660 08 52 08 52 08 52 53 08 53 08 53 08 53 0a 20 20 20 20 20 54 68 65 20 5f 08 75 5f 08 6e 5f 08 6c   ┆ R R RS S S S      The _ u_ n_ l┆
0x660…680 5f 08 69 5f 08 6e 5f 08 6b 20 73 75 63 63 65 65 64 73 20 75 6e 6c 65 73 73 3a 0a 0a 20 20 20 20   ┆_ i_ n_ k succeeds unless:      ┆
0x680…6a0 20 5b 45 41 43 43 45 53 5d 20 20 20 20 20 20 20 45 69 74 68 65 72 20 73 65 61 72 63 68 20 70 65   ┆ [EACCES]       Either search pe┆
0x6a0…6c0 72 6d 69 73 73 69 6f 6e 20 69 73 20 64 65 6e 69 65 64 20 66 6f 72 20 61 20 63 6f 6d 2d 0a 20 20   ┆rmission is denied for a com-   ┆
0x6c0…6e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 6f 6e 65 6e 74 20 6f 66 20 74 68 65 20   ┆                  ponent of the ┆
0x6e0…700 70 61 74 68 20 70 72 65 66 69 78 2c 20 6f 72 20 77 72 69 74 65 20 70 65 72 6d 69 73 2d 0a 20 20   ┆path prefix, or write permis-   ┆
0x700…720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 69 6f 6e 20 69 73 20 64 65 6e 69 65 64   ┆                  sion is denied┆
0x720…740 20 6f 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 0a 20 20 20   ┆ on the directory containing    ┆
0x740…760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 6c 69 6e 6b 20 74 6f 20 62 65 20   ┆                 the link to be ┆
0x760…780 72 65 6d 6f 76 65 64 2e 0a 0a 20 20 20 20 20 5b 45 42 55 53 59 5d 20 20 20 20 20 20 20 20 54 68   ┆removed.       [EBUSY]        Th┆
0x780…7a0 65 20 65 6e 74 72 79 20 74 6f 20 62 65 20 75 6e 6c 69 6e 6b 65 64 20 69 73 20 74 68 65 20 6d 6f   ┆e entry to be unlinked is the mo┆
0x7a0…7c0 75 6e 74 20 70 6f 69 6e 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 6f   ┆unt point                     fo┆
0x7c0…7e0 72 20 61 20 6d 6f 75 6e 74 65 64 20 66 69 6c 65 20 73 79 73 74 65 6d 2e 0a 0a 20 20 20 20 20 5b   ┆r a mounted file system.       [┆
0x7e0…800 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 69 6e 74   ┆EFAULT]       _ P_ a_ t_ h point┆
0x800…820 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 61 74 65   ┆s outside the process's allocate┆
0x820…840 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 20 73 70   ┆d                     address sp┆
0x840…860 61 63 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   ┆ace.       [ELOOP]        Too ma┆
0x860…880 6e 79 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   ┆ny symbolic links were encounter┆
0x880…8a0 65 64 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   ┆ed in                     transl┆
0x8a0…8c0 61 74 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   ┆ating the pathname.       [ENOEN┆
0x8c0…8e0 54 5d 20 20 20 20 20 20 20 45 69 74 68 65 72 20 74 68 65 20 6e 61 6d 65 64 20 66 69 6c 65 20 64   ┆T]       Either the named file d┆
0x8e0…900 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 6f 72 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20   ┆oes not exist, or the           ┆
0x900…920 20 20 20 20 20 20 20 20 20 20 70 61 74 68 20 6e 61 6d 65 20 69 73 20 74 6f 6f 20 6c 6f 6e 67 2e   ┆          path name is too long.┆
0x920…940 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 6e 65 6e   ┆       [ENOTDIR]      A componen┆
0x940…960 74 20 6f 66 20 74 68 65 20 70 61 74 68 20 70 72 65 66 69 78 20 69 73 20 6e 6f 74 20 61 0a 20 20   ┆t of the path prefix is not a   ┆
0x960…980 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 69 72 65 63 74 6f 72 79 2e 0a 0a 20 20   ┆                  directory.    ┆
0x980…9a0 20 20 20 5b 45 50 45 52 4d 5d 20 20 20 20 20 20 20 20 54 68 65 20 70 61 74 68 20 63 6f 6e 74 61   ┆   [EPERM]        The path conta┆
0x9a0…9c0 69 6e 73 20 61 20 63 68 61 72 61 63 74 65 72 20 77 69 74 68 20 74 68 65 20 68 69 67 68 2d 0a 20   ┆ins a character with the high-  ┆
0x9c0…9e0 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 65 74   ┆                   order bit set┆
0x9e0…a00 2e 0a 0a 20 20 20 20 20 5b 45 52 4f 46 53 5d 20 20 20 20 20 20 20 20 54 68 65 20 6e 61 6d 65 64   ┆.       [EROFS]        The named┆
0xa00…a20 20 66 69 6c 65 20 72 65 73 69 64 65 73 20 6f 6e 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 66 69 6c   ┆ file resides on a read-only fil┆
0xa20…a40 65 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 79 73 74   ┆e                           syst┆
0xa40…a60 65 6d 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   ┆em.  S S S SE E E EE E E E A A A┆
0xa60…a80 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┆
0xa80…aa0 74 65 6d 20 43 61 6c 6c 73 20 28 32 29 3a 20 20 63 6c 6f 73 65 2c 20 6c 69 6e 6b 2c 20 72 6d 64   ┆tem Calls (2):  close, link, rmd┆
0xaa0…ac0 69 72 0a 0a 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   ┆ir  March 1989                  ┆
0xac0…ae0 20 20 20 20 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   ┆            TX Programmer's Refe┆
0xae0…b00 72 65 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆rence                           ┆
0xb00…b1c 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a               ┆                            ┆