#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: man-pages-l10n VERSION\n"
"POT-Creation-Date: 2014-07-17 17:57+0900\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: man-pages/man7/mq_overview.7:26
#, no-wrap
msgid "MQ_OVERVIEW"
msgstr ""

#. type: TH
#: man-pages/man7/mq_overview.7:26
#, no-wrap
msgid "2009-09-27"
msgstr ""

#. type: TH
#: man-pages/man7/mq_overview.7:26
#, no-wrap
msgid "Linux"
msgstr ""

#. type: TH
#: man-pages/man7/mq_overview.7:26
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""

#. type: SH
#: man-pages/man7/mq_overview.7:27
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:29
msgid "mq_overview - overview of POSIX message queues"
msgstr ""

#. type: SH
#: man-pages/man7/mq_overview.7:29
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:37
msgid ""
"POSIX message queues allow processes to exchange data in the form of "
"messages.  This API is distinct from that provided by System V message "
"queues (B<msgget>(2), B<msgsnd>(2), B<msgrcv>(2), etc.), but provides "
"similar functionality."
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:52
msgid ""
"Message queues are created and opened using B<mq_open>(3); this function "
"returns a I<message queue descriptor> (I<mqd_t>), which is used to refer to "
"the open message queue in later calls.  Each message queue is identified by "
"a name of the form I</somename>; that is, a null-terminated string of up to "
"B<NAME_MAX> (i.e., 255) characters consisting of an initial slash, followed "
"by one or more characters, none of which are slashes.  Two processes can "
"operate on the same queue by passing the same name to B<mq_open>(3)."
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:68
msgid ""
"Messages are transferred to and from a queue using B<mq_send>(3)  and "
"B<mq_receive>(3).  When a process has finished using the queue, it closes it "
"using B<mq_close>(3), and when the queue is no longer required, it can be "
"deleted using B<mq_unlink>(3).  Queue attributes can be retrieved and (in "
"some cases) modified using B<mq_getattr>(3)  and B<mq_setattr>(3).  A "
"process can request asynchronous notification of the arrival of a message on "
"a previously empty queue using B<mq_notify>(3)."
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:81
msgid ""
"A message queue descriptor is a reference to an I<open message queue "
"description> (cf.  B<open>(2)).  After a B<fork>(2), a child inherits copies "
"of its parent's message queue descriptors, and these descriptors refer to "
"the same open message queue descriptions as the corresponding descriptors in "
"the parent.  Corresponding descriptors in the two processes share the flags "
"(I<mq_flags>)  that are associated with the open message queue description."
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:94
msgid ""
"Each message has an associated I<priority>, and messages are always "
"delivered to the receiving process highest priority first.  Message "
"priorities range from 0 (low) to I<sysconf(_SC_MQ_PRIO_MAX)\\ -\\ 1> (high). "
" On Linux, I<sysconf(_SC_MQ_PRIO_MAX)> returns 32768, but POSIX.1-2001 "
"requires only that an implementation support at least priorities in the "
"range 0 to 31; some implementations provide only this range."
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:97
msgid ""
"The remainder of this section describes some specific details of the Linux "
"implementation of POSIX message queues."
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:97
#, no-wrap
msgid "Library interfaces and system calls"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:103
msgid ""
"In most cases the B<mq_*>()  library interfaces listed above are implemented "
"on top of underlying system calls of the same name.  Deviations from this "
"scheme are indicated in the following table:"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:107
#, no-wrap
msgid "Library interface	System call\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:108
#, no-wrap
msgid "mq_close(3)	close(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:109
#, no-wrap
msgid "mq_getattr(3)	mq_getsetattr(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:110
#, no-wrap
msgid "mq_notify(3)	mq_notify(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:111
#, no-wrap
msgid "mq_open(3)	mq_open(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:112
#, no-wrap
msgid "mq_receive(3)	mq_timedreceive(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:113
#, no-wrap
msgid "mq_send(3)	mq_timedsend(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:114
#, no-wrap
msgid "mq_setattr(3)	mq_getsetattr(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:115
#, no-wrap
msgid "mq_timedreceive(3)	mq_timedreceive(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:116
#, no-wrap
msgid "mq_timedsend(3)	mq_timedsend(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/mq_overview.7:117
#, no-wrap
msgid "mq_unlink(3)	mq_unlink(2)\n"
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:120
#, no-wrap
msgid "Versions"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:123
msgid ""
"POSIX message queues have been supported on Linux since kernel 2.6.6.  Glibc "
"support has been provided since version 2.3.4."
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:123
#, no-wrap
msgid "Kernel configuration"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:128
msgid ""
"Support for POSIX message queues is configurable via the "
"B<CONFIG_POSIX_MQUEUE> kernel configuration option.  This option is enabled "
"by default."
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:128
#, no-wrap
msgid "Persistence"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:133
msgid ""
"POSIX message queues have kernel persistence: if not removed by "
"B<mq_unlink>(3), a message queue will exist until the system is shut down."
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:133
#, no-wrap
msgid "Linking"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:138
msgid ""
"Programs using the POSIX message queue API must be compiled with I<cc -lrt> "
"to link against the real-time library, I<librt>."
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:138
#, no-wrap
msgid "/proc interfaces"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:141
msgid ""
"The following interfaces can be used to limit the amount of kernel memory "
"consumed by POSIX message queues:"
msgstr ""

#. type: TP
#: man-pages/man7/mq_overview.7:141
#, no-wrap
msgid "I</proc/sys/fs/mqueue/msg_max>"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:162
msgid ""
"This file can be used to view and change the ceiling value for the maximum "
"number of messages in a queue.  This value acts as a ceiling on the I<attr-"
"E<gt>mq_maxmsg> argument given to B<mq_open>(3).  The default value for "
"I<msg_max> is 10.  The minimum value is 1 (10 in kernels before 2.6.28).  "
"The upper limit is B<HARD_MAX>: I<(131072\\ /\\ sizeof(void\\ *))> (32768 on "
"Linux/86).  This limit is ignored for privileged processes "
"(B<CAP_SYS_RESOURCE>), but the B<HARD_MAX> ceiling is nevertheless imposed."
msgstr ""

#. type: TP
#: man-pages/man7/mq_overview.7:162
#, no-wrap
msgid "I</proc/sys/fs/mqueue/msgsize_max>"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:181
msgid ""
"This file can be used to view and change the ceiling on the maximum message "
"size.  This value acts as a ceiling on the I<attr-E<gt>mq_msgsize> argument "
"given to B<mq_open>(3).  The default value for I<msgsize_max> is 8192 bytes. "
" The minimum value is 128 (8192 in kernels before 2.6.28).  The upper limit "
"for I<msgsize_max> is 1,048,576 (in kernels before 2.6.28, the upper limit "
"was B<INT_MAX>; that is, 2,147,483,647 on Linux/86).  This limit is ignored "
"for privileged processes (B<CAP_SYS_RESOURCE>)."
msgstr ""

#. type: TP
#: man-pages/man7/mq_overview.7:181
#, no-wrap
msgid "I</proc/sys/fs/mqueue/queues_max>"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:191
msgid ""
"This file can be used to view and change the system-wide limit on the number "
"of message queues that can be created.  Only privileged processes "
"(B<CAP_SYS_RESOURCE>)  can create new message queues once this limit has "
"been reached.  The default value for I<queues_max> is 256; it can be changed "
"to any value in the range 0 to INT_MAX."
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:191
#, no-wrap
msgid "Resource limit"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:198
msgid ""
"The B<RLIMIT_MSGQUEUE> resource limit, which places a limit on the amount of "
"space that can be consumed by all of the message queues belonging to a "
"process's real user ID, is described in B<getrlimit>(2)."
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:198
#, no-wrap
msgid "Mounting the message queue filesystem"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:204
msgid ""
"On Linux, message queues are created in a virtual filesystem.  (Other "
"implementations may also provide such a feature, but the details are likely "
"to differ.)  This filesystem can be mounted (by the superuser) using the "
"following commands:"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:209
#, no-wrap
msgid "#B< mkdir /dev/mqueue>\n"
"#B< mount -t mqueue none /dev/mqueue>\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:213
msgid "The sticky bit is automatically enabled on the mount directory."
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:220
msgid ""
"After the filesystem has been mounted, the message queues on the system can "
"be viewed and manipulated using the commands usually used for files (e.g., "
"B<ls>(1)  and B<rm>(1))."
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:223
msgid ""
"The contents of each file in the directory consist of a single line "
"containing information about the queue:"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:228
#, no-wrap
msgid ""
"$B< cat /dev/mqueue/mymq>\n"
"QSIZE:129     NOTIFY:2    SIGNO:0    NOTIFY_PID:8260\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:232
msgid "These fields are as follows:"
msgstr ""

#. type: TP
#: man-pages/man7/mq_overview.7:232
#, no-wrap
msgid "B<QSIZE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:235
msgid "Number of bytes of data in all messages in the queue."
msgstr ""

#. type: TP
#: man-pages/man7/mq_overview.7:235
#, no-wrap
msgid "B<NOTIFY_PID>"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:241
msgid ""
"If this is nonzero, then the process with this PID has used B<mq_notify>(3)  "
"to register for asynchronous message notification, and the remaining fields "
"describe how notification occurs."
msgstr ""

#. type: TP
#: man-pages/man7/mq_overview.7:241
#, no-wrap
msgid "B<NOTIFY>"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:251
msgid ""
"Notification method: 0 is B<SIGEV_SIGNAL>; 1 is B<SIGEV_NONE>; and 2 is "
"B<SIGEV_THREAD>."
msgstr ""

#. type: TP
#: man-pages/man7/mq_overview.7:251
#, no-wrap
msgid "B<SIGNO>"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:255
msgid "Signal number to be used for B<SIGEV_SIGNAL>."
msgstr ""

#. type: SS
#: man-pages/man7/mq_overview.7:255
#, no-wrap
msgid "Polling message queue descriptors"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:263
msgid ""
"On Linux, a message queue descriptor is actually a file descriptor, and can "
"be monitored using B<select>(2), B<poll>(2), or B<epoll>(7).  This is not "
"portable."
msgstr ""

#. type: SH
#: man-pages/man7/mq_overview.7:263
#, no-wrap
msgid "CONFORMING TO"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:265
msgid "POSIX.1-2001."
msgstr ""

#. type: SH
#: man-pages/man7/mq_overview.7:265
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:275
msgid ""
"System V message queues (B<msgget>(2), B<msgsnd>(2), B<msgrcv>(2), etc.) are "
"an older API for exchanging messages between processes.  POSIX message "
"queues provide a better designed interface than System V message queues; on "
"the other hand POSIX message queues are less widely available (especially on "
"older systems) than System V message queues."
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:278
msgid ""
"Linux does not currently (2.6.26) support the use of access control lists "
"(ACLs) for POSIX message queues."
msgstr ""

#. type: SH
#: man-pages/man7/mq_overview.7:278
#, no-wrap
msgid "EXAMPLE"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:281
msgid ""
"An example of the use of various message queue functions is shown in "
"B<mq_notify>(3)."
msgstr ""

#. type: SH
#: man-pages/man7/mq_overview.7:281
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:294
msgid ""
"B<getrlimit>(2), B<mq_getsetattr>(2), B<poll>(2), B<select>(2), "
"B<mq_close>(3), B<mq_getattr>(3), B<mq_notify>(3), B<mq_open>(3), "
"B<mq_receive>(3), B<mq_send>(3), B<mq_unlink>(3), B<epoll>(7)"
msgstr ""

#. type: SH
#: man-pages/man7/mq_overview.7:294
#, no-wrap
msgid "COLOPHON"
msgstr ""

#. type: Plain text
#: man-pages/man7/mq_overview.7:302
msgid ""
"This page is part of release 3.70 of the Linux I<man-pages> project.  A "
"description of the project, information about reporting bugs, and the latest "
"version of this page, can be found at \\%http://www.kernel.org/doc/man-pages/"
"."
msgstr ""