| mqueuefs.5 (153108) | mqueuefs.5 (162872) |
|---|---|
| 1.\" Copyright (c) 2005 David Xu <davidxu@FreeBSD.org> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice(s), this list of conditions and the following disclaimer as --- 11 unchanged lines hidden (view full) --- 20.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 21.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 22.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 23.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 24.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 25.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 26.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27.\" | 1.\" Copyright (c) 2005 David Xu <davidxu@FreeBSD.org> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice(s), this list of conditions and the following disclaimer as --- 11 unchanged lines hidden (view full) --- 20.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 21.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 22.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 23.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 24.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 25.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 26.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27.\" |
| 28.\" $FreeBSD: head/share/man/man5/mqueuefs.5 153108 2005-12-05 09:31:23Z davidxu $ | 28.\" $FreeBSD: head/share/man/man5/mqueuefs.5 162872 2006-09-30 16:01:33Z ru $ 29.\" |
| 29.Dd November 30, 2005 30.Dt MQUEUEFS 5 31.Os 32.Sh NAME 33.Nm mqueuefs 34.Nd POSIX message queue file system 35.Sh SYNOPSIS | 30.Dd November 30, 2005 31.Dt MQUEUEFS 5 32.Os 33.Sh NAME 34.Nm mqueuefs 35.Nd POSIX message queue file system 36.Sh SYNOPSIS |
| 36To link into kernel 37.Dl Cd "options P1003_1B_MQUEUE" | 37To link into kernel: |
| 38.Pp | 38.Pp |
| 39To load as a kernel loadable module 40.Dl kldload mqueuefs | 39.D1 Cd "options P1003_1B_MQUEUE" 40.Pp 41To load as a kernel loadable module: 42.Pp 43.Dl "kldload mqueuefs" |
| 41.Sh DESCRIPTION 42The 43.Nm 44module will permit the 45.Fx | 44.Sh DESCRIPTION 45The 46.Nm 47module will permit the 48.Fx |
| 46kernel to support POSIX message queue. 47The module contains system call to manipulate POSIX message queue. | 49kernel to support 50.Tn POSIX 51message queue. 52The module contains system calls to manipulate 53.Tn POSIX 54message queues. |
| 48It also contains a file system to implement a view for all message queues of | 55It also contains a file system to implement a view for all message queues of |
| 49the system. This helps users to keep track of their message queues and make | 56the system. 57This helps users to keep track of their message queues and make |
| 50it more easily usable without having to invent additional tools. 51.Pp | 58it more easily usable without having to invent additional tools. 59.Pp |
| 52The most common usage follows: | 60The most common usage is as follows: |
| 53.Pp 54.Dl "mount -t mqueuefs null /mnt/mqueue" 55.Pp 56where 57.Pa /mnt/mqueue | 61.Pp 62.Dl "mount -t mqueuefs null /mnt/mqueue" 63.Pp 64where 65.Pa /mnt/mqueue |
| 58is a mount point. | 66is a mount point. |
| 59.Pp 60It is possible to define an entry in 61.Pa /etc/fstab 62that looks similar to: 63.Bd -literal 64null /mnt/mqueue mqueuefs rw 0 0 65.Ed 66.Pp | 67.Pp 68It is possible to define an entry in 69.Pa /etc/fstab 70that looks similar to: 71.Bd -literal 72null /mnt/mqueue mqueuefs rw 0 0 73.Ed 74.Pp |
| 67This will mount mqueuefs at the | 75This will mount 76.Nm 77at the |
| 68.Pa /mnt/mqueue 69mount point during system boot. 70Using 71.Pa /mnt/mqueue 72as a permanent mount point is not advised as its intention 73has always been to be a temporary mount point. 74See 75.Xr hier 7 76for more information on 77.Fx 78directory layout. 79.Pp | 78.Pa /mnt/mqueue 79mount point during system boot. 80Using 81.Pa /mnt/mqueue 82as a permanent mount point is not advised as its intention 83has always been to be a temporary mount point. 84See 85.Xr hier 7 86for more information on 87.Fx 88directory layout. 89.Pp |
| 80Some common tools can be used on the file system, e.g: | 90Some common tools can be used on the file system, e.g.: |
| 81.Xr cat 1 , 82.Xr chmod 1 , 83.Xr chown 8 , 84.Xr ls 1 , 85.Xr rm 1 , | 91.Xr cat 1 , 92.Xr chmod 1 , 93.Xr chown 8 , 94.Xr ls 1 , 95.Xr rm 1 , |
| 86etcs. 87To only use the message queue system call, it is not necessary for | 96etc. 97To use only the message queue system calls, it is not necessary for |
| 88user to mount the file system, just load the module or compile it | 98user to mount the file system, just load the module or compile it |
| 89into the kernel. Manually creating a file, for example, touch 90.Pa /mnt/mqueue/myqueue , 91will create a message queue named myqueue in the kernel, default 92message queue attributes will be applied to the queue, it is not 93advised to use this method to create a queue, it is better to use | 99into the kernel. 100Manually creating a file, for example, 101.Dq Li "touch /mnt/mqueue/myqueue" , 102will create a message queue named 103.Pa myqueue 104in the kernel, default 105message queue attributes will be applied to the queue. 106It is not 107advised to use this method to create a queue; 108it is better to use the |
| 94.Xr mq_open 2 | 109.Xr mq_open 2 |
| 95system call to create the queue, the 96.Xr mq_open 2 97allows user to specify differnt attributes. | 110system call to create a queue as it 111allows the user to specify different attributes. |
| 98.Pp 99To see the queue's attributes, just read the file: 100.Pp | 112.Pp 113To see the queue's attributes, just read the file: 114.Pp |
| 101.Dl cat /mnt/mqueue/myqueue | 115.Dl "cat /mnt/mqueue/myqueue" |
| 102.Sh SEE ALSO | 116.Sh SEE ALSO |
| 103.Xr mq_open 2 , | |
| 104.Xr mount 2 , | 117.Xr mount 2 , |
| 118.Xr mq_open 2 , |
|
| 105.Xr unmount 2 , 106.Xr mount 8 , | 119.Xr unmount 2 , 120.Xr mount 8 , |
| 107.Xr umount 8 . | 121.Xr umount 8 |
| 108.Sh AUTHORS 109This manual page was written by 110.An "David Xu" Aq davidxu@FreeBSD.org . | 122.Sh AUTHORS 123This manual page was written by 124.An "David Xu" Aq davidxu@FreeBSD.org . |