DataMuseum.dk

top - download

    Length: 2845 (0xb1d)
    Names: »closeutimes.2«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./bsd/usr/man/cat2/closeutimes.2« 
        └─⟦this⟧ »./usr/man/cat2/closeutimes.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 63 6c 6f 73 65 75 74 69 6d 65 73 28 32 29 0a 0a 0a 0a   ┆s             closeutimes(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 6c 6f 73 65 75 74 69 6d 65 73 20 2d 20 63 6c 6f 73 65 20 61 20 72 65 67 75 6c 61 72 20   ┆  closeutimes - close a regular ┆
0x0a0…0c0 64 69 73 6b 20 66 69 6c 65 20 61 6e 64 20 73 65 74 20 74 68 65 20 66 69 6c 65 27 73 0a 20 20 20   ┆disk file and set the file's    ┆
0x0c0…0e0 20 20 74 69 6d 65 73 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   ┆  times  S S S SY Y Y YN N N NT ┆
0x0e0…100 54 08 54 08 54 41 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 23 08 23 08 23 08 23   ┆T T TA A A AX X X X      # # # #┆
0x100…120 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 63 6c 08 6c 08 6c 08 6c 75 08 75 08   ┆i i i in n n nc c c cl l l lu u ┆
0x120…140 75 08 75 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08 73 08 73 08 73   ┆u ud d d de e e e < < < <s s s s┆
0x140…160 79 08 79 08 79 08 79 73 08 73 08 73 08 73 2f 08 2f 08 2f 08 2f 74 08 74 08 74 08 74 69 08 69 08   ┆y y y ys s s s/ / / /t t t ti i ┆
0x160…180 69 08 69 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e   ┆i im m m me e e e. . . .h h h h>┆
0x180…1a0 08 3e 08 3e 08 3e 0a 20 20 20 20 20 63 08 63 08 63 08 63 6c 08 6c 08 6c 08 6c 6f 08 6f 08 6f 08   ┆ > > >      c c c cl l l lo o o ┆
0x1a0…1c0 6f 73 08 73 08 73 08 73 65 08 65 08 65 08 65 75 08 75 08 75 08 75 74 08 74 08 74 08 74 69 08 69   ┆os s s se e e eu u u ut t t ti i┆
0x1c0…1e0 08 69 08 69 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 73 08 73 08 73 08 73 28 08 28 08 28 08 28   ┆ i im m m me e e es s s s( ( ( (┆
0x1e0…200 66 08 66 08 66 08 66 64 08 64 08 64 08 64 2c 08 2c 08 2c 08 2c 20 74 08 74 08 74 08 74 76 08 76   ┆f f f fd d d d, , , , t t t tv v┆
0x200…220 08 76 08 76 70 08 70 08 70 08 70 29 08 29 08 29 08 29 0a 20 20 20 20 20 69 08 69 08 69 08 69 6e   ┆ v vp p p p) ) ) )      i i i in┆
0x220…240 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 66 08 66 08 66 08 66 64 08 64 08 64 08 64 3b 08 3b 08   ┆ n n nt t t t f f f fd d d d; ; ┆
0x240…260 3b 08 3b 0a 20 20 20 20 20 73 08 73 08 73 08 73 74 08 74 08 74 08 74 72 08 72 08 72 08 72 75 08   ┆; ;      s s s st t t tr r r ru ┆
0x260…280 75 08 75 08 75 63 08 63 08 63 08 63 74 08 74 08 74 08 74 20 74 08 74 08 74 08 74 69 08 69 08 69   ┆u u uc c c ct t t t t t t ti i i┆
0x280…2a0 08 69 6d 08 6d 08 6d 08 6d 65 08 65 08 65 08 65 76 08 76 08 76 08 76 61 08 61 08 61 08 61 6c 08   ┆ im m m me e e ev v v va a a al ┆
0x2a0…2c0 6c 08 6c 08 6c 20 2a 08 2a 08 2a 08 2a 74 08 74 08 74 08 74 76 08 76 08 76 08 76 70 08 70 08 70   ┆l l l * * * *t t t tv v v vp p p┆
0x2c0…2e0 08 70 5b 08 5b 08 5b 08 5b 32 08 32 08 32 08 32 5d 08 5d 08 5d 08 5d 3b 08 3b 08 3b 08 3b 0a 0a   ┆ p[ [ [ [2 2 2 2] ] ] ]; ; ; ;  ┆
0x2e0…300 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 43 08 43 52 08 52 08   ┆D D D DE E E ES S S SC C C CR R ┆
0x300…320 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 08 49 08 49 08 49 4f   ┆R RI I I IP P P PT T T TI I I IO┆
0x320…340 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 5f 08 63 5f 08 6c 5f 08 6f   ┆ O O ON N N N      The _ c_ l_ o┆
0x340…360 5f 08 73 5f 08 65 5f 08 75 5f 08 74 5f 08 69 5f 08 6d 5f 08 65 5f 08 73 20 63 61 6c 6c 20 69 73   ┆_ s_ e_ u_ t_ i_ m_ e_ s call is┆
0x360…380 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 74 68 65 20 5f 08 63 5f 08 6c 5f 08 6f 5f 08 73 5f   ┆ equivalent to the _ c_ l_ o_ s_┆
0x380…3a0 08 65 20 73 79 73 74 65 6d 20 63 61 6c 6c 0a 20 20 20 20 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20   ┆ e system call      followed by ┆
0x3a0…3c0 74 68 65 20 5f 08 75 5f 08 74 5f 08 69 5f 08 6d 5f 08 65 5f 08 73 20 73 79 73 74 65 6d 20 63 61   ┆the _ u_ t_ i_ m_ e_ s system ca┆
0x3c0…3e0 6c 6c 2e 20 20 54 68 65 73 65 20 72 65 73 74 72 69 63 74 69 6f 6e 73 0a 20 20 20 20 20 61 70 70   ┆ll.  These restrictions      app┆
0x3e0…400 6c 79 20 74 6f 20 5f 08 63 5f 08 6c 5f 08 6f 5f 08 73 5f 08 65 5f 08 75 5f 08 74 5f 08 69 5f 08   ┆ly to _ c_ l_ o_ s_ e_ u_ t_ i_ ┆
0x400…420 6d 5f 08 65 5f 08 73 3a 0a 0a 20 20 20 20 20 31 29 20 20 20 63 61 6e 6e 6f 74 20 62 65 20 75 73   ┆m_ e_ s:       1)   cannot be us┆
0x420…440 65 64 20 77 68 69 6c 65 20 61 20 70 72 6f 63 65 73 73 20 69 73 20 69 6e 20 74 72 61 6e 73 61 63   ┆ed while a process is in transac┆
0x440…460 74 69 6f 6e 20 73 74 61 74 65 2e 0a 0a 20 20 20 20 20 32 29 20 20 20 63 61 6e 6e 6f 74 20 62 65   ┆tion state.       2)   cannot be┆
0x460…480 20 75 73 65 64 20 6f 6e 20 61 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 6e 6f 74 20 61 20 72 65   ┆ used on a file that is not a re┆
0x480…4a0 67 75 6c 61 72 20 64 69 73 6b 0a 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 2e 0a 0a 20 20 20 20   ┆gular disk           file.      ┆
0x4a0…4c0 20 33 29 20 20 20 63 61 6e 6e 6f 74 20 62 65 20 75 73 65 64 20 6f 6e 20 61 20 66 69 6c 65 20 74   ┆ 3)   cannot be used on a file t┆
0x4c0…4e0 68 61 74 20 69 73 20 6f 70 65 6e 65 64 20 69 6e 20 63 6f 6e 74 72 6f 6c 6c 65 64 0a 20 20 20 20   ┆hat is opened in controlled     ┆
0x4e0…500 20 20 20 20 20 20 6d 6f 64 65 2e 0a 0a 20 20 20 20 20 33 29 20 20 20 54 68 65 20 63 61 6c 6c 65   ┆      mode.       3)   The calle┆
0x500…520 72 20 6d 75 73 74 20 62 65 20 74 68 65 20 6f 77 6e 65 72 20 6f 66 20 74 68 65 20 66 69 6c 65 20   ┆r must be the owner of the file ┆
0x520…540 6f 72 20 74 68 65 20 73 75 70 65 72 2d 0a 20 20 20 20 20 20 20 20 20 20 75 73 65 72 2e 0a 0a 20   ┆or the super-           user.   ┆
0x540…560 20 20 20 20 54 68 65 20 5f 08 63 5f 08 6c 5f 08 6f 5f 08 73 5f 08 65 5f 08 75 5f 08 74 5f 08 69   ┆    The _ c_ l_ o_ s_ e_ u_ t_ i┆
0x560…580 5f 08 6d 5f 08 65 5f 08 73 20 63 61 6c 6c 20 63 6c 6f 73 65 73 20 74 68 65 20 66 69 6c 65 2c 20   ┆_ m_ e_ s call closes the file, ┆
0x580…5a0 66 6c 75 73 68 65 73 20 61 6c 6c 20 75 6e 77 72 69 74 74 65 6e 0a 20 20 20 20 20 62 6c 6f 63 6b   ┆flushes all unwritten      block┆
0x5a0…5c0 73 20 74 6f 20 64 69 73 6b 2c 20 61 6e 64 20 75 73 65 73 20 74 68 65 20 22 61 63 63 65 73 73 65   ┆s to disk, and uses the "accesse┆
0x5c0…5e0 64 22 20 61 6e 64 20 22 75 70 64 61 74 65 64 22 20 74 69 6d 65 73 0a 20 20 20 20 20 69 6e 20 74   ┆d" and "updated" times      in t┆
0x5e0…600 68 61 74 20 6f 72 64 65 72 20 66 72 6f 6d 20 74 68 65 20 5f 08 74 5f 08 76 5f 08 70 20 76 65 63   ┆hat order from the _ t_ v_ p vec┆
0x600…620 74 6f 72 20 74 6f 20 73 65 74 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a 20 20 20   ┆tor to set the corresponding    ┆
0x620…640 20 20 72 65 63 6f 72 64 65 64 20 74 69 6d 65 73 20 66 6f 72 20 74 68 65 20 66 69 6c 65 2e 20 20   ┆  recorded times for the file.  ┆
0x640…660 54 68 65 20 22 69 6e 6f 64 65 2d 63 68 61 6e 67 65 64 22 20 74 69 6d 65 20 6f 66 0a 20 20 20 20   ┆The "inode-changed" time of     ┆
0x660…680 20 74 68 65 20 66 69 6c 65 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 20   ┆ the file is set to the current ┆
0x680…6a0 74 69 6d 65 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08 45 08 45 54 08 54 08 54 08 54 55 08 55 08   ┆time.  R R R RE E E ET T T TU U ┆
0x6a0…6c0 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 08 41 08 41 08 41   ┆U UR R R RN N N N V V V VA A A A┆
0x6c0…6e0 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 20 30 20 69 6e 64   ┆L L L LU U U UE E E E      0 ind┆
0x6e0…700 69 63 61 74 65 73 20 73 75 63 63 65 73 73 66 75 6c 20 63 6f 6d 70 6c 65 74 69 6f 6e 2e 20 20 4f   ┆icates successful completion.  O┆
0x700…720 74 68 65 72 77 69 73 65 2c 20 2d 31 20 69 73 0a 20 20 20 20 20 72 65 74 75 72 6e 65 64 20 61 6e   ┆therwise, -1 is      returned an┆
0x720…740 64 20 74 68 65 20 65 72 72 6f 72 20 69 73 20 69 6e 64 69 63 61 74 65 64 20 62 79 20 5f 08 65 5f   ┆d the error is indicated by _ e_┆
0x740…760 08 72 5f 08 72 5f 08 6e 5f 08 6f 2e 0a 0a 45 08 45 08 45 08 45 52 08 52 08 52 08 52 52 08 52 08   ┆ r_ r_ n_ o.  E E E ER R R RR R ┆
0x760…780 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 20 20 20 5f 08   ┆R RO O O OR R R RS S S S      _ ┆
0x780…7a0 63 5f 08 6c 5f 08 6f 5f 08 73 5f 08 65 5f 08 75 5f 08 74 5f 08 69 5f 08 6d 5f 08 65 5f 08 73 20   ┆c_ l_ o_ s_ e_ u_ t_ i_ m_ e_ s ┆
0x7a0…7c0 77 69 6c 6c 20 66 61 69 6c 20 69 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 20   ┆will fail if one or more of the ┆
0x7c0…7e0 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 0a 20 20 20 20 20 74 72 75 65 3a 0a 0a 20 20 20 20 20 5b   ┆following are      true:       [┆
0x7e0…800 45 42 41 44 46 5d 20 20 20 20 20 20 20 20 45 69 74 68 65 72 20 5f 08 66 5f 08 64 20 69 73 20 6e   ┆EBADF]        Either _ f_ d is n┆
0x800…820 6f 74 20 61 6e 20 61 63 74 69 76 65 20 64 65 73 63 72 69 70 74 6f 72 2c 20 6f 72 20 5f 08 64 0a   ┆ot an active descriptor, or _ d ┆
0x820…840 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6e 6e 6f 74 20 62 65 20 63 6c   ┆                    cannot be cl┆
0x840…860 6f 73 65 64 20 69 6e 73 69 64 65 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62 65 63 61 75 73   ┆osed inside a transaction becaus┆
0x860…880 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 74 20 77 61 73 20 6f 70 65   ┆e                     it was ope┆
0x880…8a0 6e 65 64 20 6f 75 74 73 69 64 65 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 0a 20 20   ┆ned outside the transaction.    ┆
0x8a0…8c0 20 20 20 5b 45 46 41 55 4c 54 5d 20 20 20 20 20 20 20 5f 08 54 5f 08 76 5f 08 70 20 70 6f 69 6e   ┆   [EFAULT]       _ T_ v_ p poin┆
0x8c0…8e0 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 61 74   ┆ts outside the process's allocat┆
0x8e0…900 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 20 73   ┆ed                     address s┆
0x900…920 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 54 68 65 20 66   ┆pace.       [EINVAL]       The f┆
0x920…940 69 6c 65 20 69 73 20 6f 70 65 6e 20 69 6e 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 6d 6f 64 65 2e 0a   ┆ile is open in controlled mode. ┆
0x940…960 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 70 72 6f 63 65 73 73   ┆      [EPERM]        The process┆
0x960…980 20 69 73 20 6e 6f 74 20 73 75 70 65 72 2d 75 73 65 72 20 6f 72 20 74 68 65 20 6f 77 6e 65 72 20   ┆ is not super-user or the owner ┆
0x980…9a0 6f 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 66 69 6c 65 2e   ┆of                     the file.┆
0x9a0…9c0 0a 0a 20 20 20 20 20 5b 45 52 45 47 5d 20 20 20 20 20 20 20 20 20 54 68 65 20 66 69 6c 65 20 64   ┆       [EREG]         The file d┆
0x9c0…9e0 65 73 63 72 69 70 74 6f 72 20 64 6f 65 73 20 6e 6f 74 20 72 65 66 65 72 20 74 6f 20 61 20 72 65   ┆escriptor does not refer to a re┆
0x9e0…a00 67 75 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 61 72 20 64 69 73 6b   ┆gu-                     lar disk┆
0xa00…a20 20 66 69 6c 65 2e 0a 0a 20 20 20 20 20 5b 45 54 52 41 4e 5d 20 20 20 20 20 20 20 20 54 68 65 20   ┆ file.       [ETRAN]        The ┆
0xa20…a40 70 72 6f 63 65 73 73 20 69 73 20 69 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 6f 64 65 2e 0a   ┆process is in transaction mode. ┆
0xa40…a60 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 08 41 4c 08   ┆ S S S SE E E EE E E E A A A AL ┆
0xa60…a80 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 74 65 6d 20   ┆L L LS S S SO O O O      System ┆
0xa80…aa0 43 61 6c 6c 73 20 28 32 29 3a 20 20 63 6c 6f 73 65 2c 20 75 74 69 6d 65 73 0a 0a 0a 0a 0a 0a 0a   ┆Calls (2):  close, utimes       ┆
0xaa0…ac0 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                      ┆
0xac0…ae0 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┆
0xae0…b00 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 0a 0a 0a 0a   ┆e                               ┆
0xb00…b1d 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 0a            ┆                             ┆