aboutsummaryrefslogtreecommitdiff
path: root/coreutils-5.3.0-bin/man/cat1p/mkfifo.1p.txt
blob: 42442b14de52665ba6b879cf1096b55abc80acf7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
mkfifo(P)                                             mkfifo(P)





NAME
       mkfifo - make FIFO special files

SYNOPSIS
       mkfifo [-m mode] file...

DESCRIPTION
       The  mkfifo  utility shall create the FIFO special files
       specified by the operands, in the order specified.

       For each file operand, the mkfifo utility shall  perform
       actions  equivalent  to the mkfifo() function defined in
       the System Interfaces  volume  of  IEEE Std 1003.1-2001,
       called with the following arguments:

       The file operand is used as the path argument.

       The  value  of  the  bitwise-inclusive  OR  of  S_IRUSR,
       S_IWUSR, S_IRGRP, S_IWGRP, S_IROTH, and S_IWOTH is  used
       as  the  mode  argument. (If the -m option is specified,
       the value of the mkfifo() mode argument is  unspecified,
       but  the  FIFO  shall  at  no time have permissions less
       restrictive than the -m mode option-argument.)

OPTIONS
       The mkfifo utility shall conform to the Base Definitions
       volume  of  IEEE Std 1003.1-2001,  Section 12.2, Utility
       Syntax Guidelines.

       The following option shall be supported:

       -m  mode
              Set the file permission bits of the newly-created
              FIFO  to  the  specified  mode  value.  The  mode
              option-argument shall be the same as the mode op-
              erand  defined for the chmod utility. In the sym-
              bolic_mode strings, the op characters '+' and '-'
              shall  be interpreted relative to an assumed ini-
              tial mode of a= rw.


OPERANDS
       The following operand shall be supported:

       file   A pathname of the FIFO special file  to  be  cre-
              ated.


STDIN
       Not used.

INPUT FILES
       None.

ENVIRONMENT VARIABLES
       The  following  environment  variables  shall affect the
       execution of mkfifo:

       LANG   Provide a default value for the internationaliza-
              tion  variables  that are unset or null. (See the
              Base Definitions volume of  IEEE Std 1003.1-2001,
              Section  8.2,  Internationalization Variables for
              the precedence of internationalization  variables
              used   to   determine   the   values   of  locale
              categories.)

       LC_ALL If set to a non-empty string value, override  the
              values  of  all  the  other  internationalization
              variables.

       LC_CTYPE
              Determine the locale for  the  interpretation  of
              sequences  of  bytes  of  text data as characters
              (for example, single-byte as  opposed  to  multi-
              byte characters in arguments).

       LC_MESSAGES
              Determine  the  locale  that  should  be  used to
              affect the format and contents of diagnostic mes-
              sages written to standard error.

       NLSPATH
              Determine  the  location  of message catalogs for
              the processing of LC_MESSAGES .


ASYNCHRONOUS EVENTS
       Default.

STDOUT
       Not used.

STDERR
       The standard error shall be  used  only  for  diagnostic
       messages.

OUTPUT FILES
       None.

EXTENDED DESCRIPTION
       None.

EXIT STATUS
       The following exit values shall be returned:

        0     All the specified FIFO special files were created
              successfully.

       >0     An error occurred.


CONSEQUENCES OF ERRORS
       Default.

       The following sections are informative.

APPLICATION USAGE
       None.

EXAMPLES
       None.

RATIONALE
       This utility was added to permit shell  applications  to
       create FIFO special files.

       The  -m  option  was added to control the file mode, for
       consistency with the similar functionality  provided  by
       the mkdir utility.

       Early  proposals  included  a  -p  option similar to the
       mkdir -p option that  created  intermediate  directories
       leading up to the FIFO specified by the final component.
       This was removed because it is not commonly  needed  and
       is not common practice with similar utilities.

       The  functionality  of mkfifo is described substantially
       through a reference to the mkfifo() function in the Sys-
       tem Interfaces volume of IEEE Std 1003.1-2001. For exam-
       ple, by default, the mode of the FIFO file  is  affected
       by  the  file  mode creation mask in accordance with the
       specified behavior of the  mkfifo()  function.  In  this
       way,  there  is  less duplication of effort required for
       describing details of the file creation.

FUTURE DIRECTIONS
       None.

SEE ALSO
       chmod() , umask() ,  the  System  Interfaces  volume  of
       IEEE Std 1003.1-2001, mkfifo()

COPYRIGHT
       Portions  of  this  text are reprinted and reproduced in
       electronic form from  IEEE  Std  1003.1,  2003  Edition,
       Standard  for Information Technology -- Portable Operat-
       ing System Interface (POSIX), The Open Group Base Speci-
       fications Issue 6, Copyright (C) 2001-2003 by the Insti-
       tute of Electrical and Electronics  Engineers,  Inc  and
       The  Open Group. In the event of any discrepancy between
       this version and the original IEEE and  The  Open  Group
       Standard,  the original IEEE and The Open Group Standard
       is the referee document. The original  Standard  can  be
       obtained        online        at        http://www.open-
       group.org/unix/online.html .



POSIX                         2003                    mkfifo(P)