DataMuseum.dk

top - download

    Length: 1932 (0x78c)
    Names: »creat.3c«

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

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 4c 69 62 72 61 72 79 20 46 75 6e 63 74   ┆ u_ a_ l           Library Funct┆
0x040…060 69 6f 6e 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 72 65 61 74 28 33 63 29 0a 0a 0a 0a   ┆ions               creat(3c)    ┆
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 72 65 61 74 20 2d 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 66 69 6c 65 0a 0a 53 08 53   ┆  creat - create a new file  S S┆
0x0a0…0c0 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 41 08 41 08 41   ┆ S SY Y Y YN N N NT T T TA A A A┆
0x0c0…0e0 58 08 58 08 58 08 58 0a 20 20 20 20 20 63 08 63 08 63 08 63 72 08 72 08 72 08 72 65 08 65 08 65   ┆X X X X      c c c cr r r re e e┆
0x0e0…100 08 65 61 08 61 08 61 08 61 74 08 74 08 74 08 74 28 08 28 08 28 08 28 6e 08 6e 08 6e 08 6e 61 08   ┆ ea a a at t t t( ( ( (n n n na ┆
0x100…120 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 6d 08 6d 08 6d   ┆a a am m m me e e e, , , , m m m┆
0x120…140 08 6d 6f 08 6f 08 6f 08 6f 64 08 64 08 64 08 64 65 08 65 08 65 08 65 29 08 29 08 29 08 29 0a 20   ┆ mo o o od d d de e e e) ) ) )  ┆
0x140…160 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 08 72   ┆    c c c ch h h ha a a ar r r r┆
0x160…180 20 2a 08 2a 08 2a 08 2a 6e 08 6e 08 6e 08 6e 61 08 61 08 61 08 61 6d 08 6d 08 6d 08 6d 65 08 65   ┆ * * * *n n n na a a am m m me e┆
0x180…1a0 08 65 08 65 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   ┆ e e; ; ; ;  D D D DE E E ES S S┆
0x1a0…1c0 08 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   ┆ SC C C CR R R RI I I IP P P PT ┆
0x1c0…1e0 54 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   ┆T T TI I I IO O O ON N N N      ┆
0x1e0…200 4e 08 4e 08 4e 08 4e 6f 08 6f 08 6f 08 6f 74 08 74 08 74 08 74 65 08 65 08 65 08 65 3a 08 3a 08   ┆N N N No o o ot t t te e e e: : ┆
0x200…220 3a 08 3a 20 20 54 68 65 20 5f 08 6f 5f 08 70 5f 08 65 5f 08 6e 20 73 79 73 74 65 6d 20 63 61 6c   ┆: :  The _ o_ p_ e_ n system cal┆
0x220…240 6c 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 69 73   ┆l should be used instead of this┆
0x240…260 0a 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 2e 20 20 53 65 65 20 61 6c 73 6f 20 74 68 65 20 5f 08   ┆      function.  See also the _ ┆
0x260…280 63 5f 08 72 5f 08 65 5f 08 61 5f 08 74 5f 08 65 5f 08 66 5f 08 69 5f 08 6c 5f 08 65 20 73 79 73   ┆c_ r_ e_ a_ t_ e_ f_ i_ l_ e sys┆
0x280…2a0 74 65 6d 20 63 61 6c 6c 2e 0a 0a 20 20 20 20 20 5f 08 63 5f 08 72 5f 08 65 5f 08 61 5f 08 74 20   ┆tem call.       _ c_ r_ e_ a_ t ┆
0x2a0…2c0 63 72 65 61 74 65 73 20 61 20 6e 65 77 20 66 69 6c 65 20 6f 72 20 70 72 65 70 61 72 65 73 20 74   ┆creates a new file or prepares t┆
0x2c0…2e0 6f 20 72 65 77 72 69 74 65 20 61 6e 20 65 78 69 73 74 69 6e 67 0a 20 20 20 20 20 66 69 6c 65 20   ┆o rewrite an existing      file ┆
0x2e0…300 63 61 6c 6c 65 64 20 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 2c 20 67 69 76 65 6e 20 61 73 20 74 68   ┆called _ n_ a_ m_ e, given as th┆
0x300…320 65 20 61 64 64 72 65 73 73 20 6f 66 20 61 20 6e 75 6c 6c 2d 74 65 72 6d 69 6e 61 74 65 64 0a 20   ┆e address of a null-terminated  ┆
0x320…340 20 20 20 20 73 74 72 69 6e 67 2e 20 20 49 66 20 74 68 65 20 66 69 6c 65 20 64 69 64 20 6e 6f 74   ┆    string.  If the file did not┆
0x340…360 20 65 78 69 73 74 2c 20 69 74 20 69 73 20 67 69 76 65 6e 20 74 68 65 20 6d 6f 64 65 0a 20 20 20   ┆ exist, it is given the mode    ┆
0x360…380 20 20 73 70 65 63 69 66 69 65 64 20 62 79 20 5f 08 6d 5f 08 6f 5f 08 64 5f 08 65 2c 20 61 73 20   ┆  specified by _ m_ o_ d_ e, as ┆
0x380…3a0 6d 6f 64 69 66 69 65 64 20 62 79 20 74 68 65 20 70 72 6f 63 65 73 73 27 73 20 6d 6f 64 65 20 6d   ┆modified by the process's mode m┆
0x3a0…3c0 61 73 6b 0a 20 20 20 20 20 28 52 65 66 65 72 20 74 6f 20 74 68 65 20 5f 08 75 5f 08 6d 5f 08 61   ┆ask      (Refer to the _ u_ m_ a┆
0x3c0…3e0 5f 08 73 5f 08 6b 20 61 6e 64 20 5f 08 63 5f 08 68 5f 08 6d 5f 08 6f 5f 08 64 20 73 79 73 74 65   ┆_ s_ k and _ c_ h_ m_ o_ d syste┆
0x3e0…400 6d 20 63 61 6c 6c 73 2e 29 0a 0a 20 20 20 20 20 49 66 20 74 68 65 20 66 69 6c 65 20 64 69 64 20   ┆m calls.)       If the file did ┆
0x400…420 65 78 69 73 74 2c 20 69 74 73 20 6d 6f 64 65 20 61 6e 64 20 6f 77 6e 65 72 20 72 65 6d 61 69 6e   ┆exist, its mode and owner remain┆
0x420…440 20 75 6e 63 68 61 6e 67 65 64 2c 0a 20 20 20 20 20 62 75 74 20 69 74 20 69 73 20 74 72 75 6e 63   ┆ unchanged,      but it is trunc┆
0x440…460 61 74 65 64 20 74 6f 20 30 20 6c 65 6e 67 74 68 2e 0a 0a 20 20 20 20 20 54 68 65 20 66 69 6c 65   ┆ated to 0 length.       The file┆
0x460…480 20 69 73 20 61 6c 73 6f 20 6f 70 65 6e 65 64 20 66 6f 72 20 77 72 69 74 69 6e 67 2c 20 61 6e 64   ┆ is also opened for writing, and┆
0x480…4a0 20 69 74 73 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 0a 20 20 20 20 20 69 73 20 72 65 74   ┆ its file descriptor      is ret┆
0x4a0…4c0 75 72 6e 65 64 2e 0a 0a 4e 08 4e 08 4e 08 4e 4f 08 4f 08 4f 08 4f 54 08 54 08 54 08 54 45 08 45   ┆urned.  N N N NO O O OT T T TE E┆
0x4c0…4e0 08 45 08 45 53 08 53 08 53 08 53 0a 20 20 20 20 20 54 68 65 20 5f 08 6d 5f 08 6f 5f 08 64 5f 08   ┆ E ES S S S      The _ m_ o_ d_ ┆
0x4e0…500 65 20 67 69 76 65 6e 20 69 73 20 61 72 62 69 74 72 61 72 79 3b 20 69 74 20 6e 65 65 64 20 6e 6f   ┆e given is arbitrary; it need no┆
0x500…520 74 20 61 6c 6c 6f 77 20 77 72 69 74 69 6e 67 2e 0a 20 20 20 20 20 54 68 69 73 20 66 65 61 74 75   ┆t allow writing.      This featu┆
0x520…540 72 65 20 68 61 73 20 62 65 65 6e 20 75 73 65 64 20 69 6e 20 74 68 65 20 70 61 73 74 20 62 79 20   ┆re has been used in the past by ┆
0x540…560 70 72 6f 67 72 61 6d 73 20 74 6f 20 63 6f 6e 2d 0a 20 20 20 20 20 73 74 72 75 63 74 20 61 20 73   ┆programs to con-      struct a s┆
0x560…580 69 6d 70 6c 65 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 69 6e 67 20 6d 65 63 68 61 6e 69 73   ┆imple exclusive locking mechanis┆
0x580…5a0 6d 2e 20 20 49 74 20 69 73 20 72 65 70 6c 61 63 65 64 0a 20 20 20 20 20 62 79 20 74 68 65 20 4f   ┆m.  It is replaced      by the O┆
0x5a0…5c0 5f 45 58 43 4c 20 6f 70 65 6e 20 6d 6f 64 65 2c 20 6f 72 20 5f 08 66 5f 08 6c 5f 08 6f 5f 08 63   ┆_EXCL open mode, or _ f_ l_ o_ c┆
0x5c0…5e0 5f 08 6b 20 73 79 73 74 65 6d 20 63 61 6c 6c 2e 0a 0a 52 08 52 08 52 08 52 45 08 45 08 45 08 45   ┆_ k system call.  R R R RE E E E┆
0x5e0…600 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┆
0x600…620 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┆
0x620…640 0a 20 20 20 20 20 54 68 65 20 76 61 6c 75 65 20 2d 31 20 69 73 20 72 65 74 75 72 6e 65 64 20 69   ┆      The value -1 is returned i┆
0x640…660 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 74   ┆f an error occurs.  Otherwise, t┆
0x660…680 68 65 0a 20 20 20 20 20 63 61 6c 6c 20 72 65 74 75 72 6e 73 20 61 20 6e 6f 6e 2d 6e 65 67 61 74   ┆he      call returns a non-negat┆
0x680…6a0 69 76 65 20 64 65 73 63 72 69 70 74 6f 72 20 77 68 69 63 68 20 6f 6e 6c 79 20 70 65 72 6d 69 74   ┆ive descriptor which only permit┆
0x6a0…6c0 73 0a 20 20 20 20 20 77 72 69 74 69 6e 67 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45   ┆s      writing.  S S S SE E E EE┆
0x6c0…6e0 08 45 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   ┆ E E E A A A AL L L LS S S SO O ┆
0x6e0…700 4f 08 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 63 68 6d 6f   ┆O O      System Calls (2):  chmo┆
0x700…720 64 2c 20 63 6c 6f 73 65 2c 20 63 72 65 61 74 65 66 69 6c 65 2c 20 66 6c 6f 63 6b 2c 20 6f 70 65   ┆d, close, createfile, flock, ope┆
0x720…740 6e 2c 0a 20 20 20 20 20 75 6d 61 73 6b 2c 20 77 72 69 74 65 0a 0a 4d 61 72 63 68 20 31 39 38 39   ┆n,      umask, write  March 1989┆
0x740…760 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 58   ┆                              TX┆
0x760…780 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 0a   ┆ Programmer's Reference         ┆
0x780…78c 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a                                                               ┆            ┆