draft/man3/mq_close.3

   1 '\" t
   2 .\" Hey Emacs! This file is -*- nroff -*- source.
   3 .\"
   4 .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
   5 .\"
   6 .\" Permission is granted to make and distribute verbatim copies of this
   7 .\" manual provided the copyright notice and this permission notice are
   8 .\" preserved on all copies.
   9 .\"
  10 .\" Permission is granted to copy and distribute modified versions of this
  11 .\" manual under the conditions for verbatim copying, provided that the
  12 .\" entire resulting derived work is distributed under the terms of a
  13 .\" permission notice identical to this one.
  14 .\"
  15 .\" Since the Linux kernel and libraries are constantly changing, this
  16 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  17 .\" responsibility for errors or omissions, or for damages resulting from
  18 .\" the use of the information contained herein.  The author(s) may not
  19 .\" have taken the same level of care in the production of this manual,
  20 .\" which is licensed free of charge, as they might when working
  21 .\" professionally.
  22 .\"
  23 .\" Formatted or processed versions of this manual, if unaccompanied by
  24 .\" the source, must acknowledge the copyright and authors of this work.
  25 .\"
  26 .\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI all rights reserved.
  27 .\" Translated 2006-04-23, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  28 .\"
  29 .TH MQ_CLOSE 3 2010-08-29 "Linux" "Linux Programmer's Manual"
  30 .\"O .SH NAME
  31 .SH 名前
  32 .\"O mq_close \- close a message queue descriptor
  33 mq_close \- メッセージキュー記述子をクローズする
  34 .\"O .SH SYNOPSIS
  35 .SH 書式
  36 .nf
  37 .B #include <mqueue.h>
  38 .sp
  39 .BI "int mq_close(mqd_t " mqdes );
  40 .fi
  41 .sp
  42 .\"O Link with \fI\-lrt\fP.
  43 \fI\-lrt\fP でリンクする。
  44 .\"O .SH DESCRIPTION
  45 .SH 説明
  46 .\"O .BR mq_close ()
  47 .\"O closes the message queue descriptor
  48 .\"O .IR mqdes .
  49 .BR mq_close ()
  50 はメッセージキュー記述子 (message queue descriptor)
  51 .I mqdes
  52 をクローズする。
  53
  54 .\"O If the calling process has attached a notification request
  55 .\"O to this message queue via
  56 .\"O .IR mqdes ,
  57 .\"O then this request is removed,
  58 .\"O and another process can now attach a notification request.
  59 呼び出し元のプロセスが
  60 .I mqdes
  61 経由でこのメッセージキューに通知要求 (notification request)
  62 を設定している場合、通知要求は削除され、他のプロセスがそのキューに
  63 対して通知要求を設定できるようになる。
  64 .\"O .SH RETURN VALUE
  65 .SH 返り値
  66 .\"O On success
  67 .\"O .BR mq_close ()
  68 .\"O returns 0; on error, \-1 is returned, with
  69 .\"O .I errno
  70 .\"O set to indicate the error.
  71 成功すると、
  72 .BR mq_close ()
  73 は 0 を返す。エラーの場合、\-1 を返し、
  74 .I errno
  75 にエラーを示す値を設定する。
  76 .\"O .SH ERRORS
  77 .SH エラー
  78 .TP
  79 .B EBADF
  80 .\"O The descriptor specified in
  81 .\"O .I mqdes
  82 .\"O is invalid.
  83 .I mqdes
  84 で指定された記述子が不正である。
  85 .\"O .SH CONFORMING TO
  86 .SH 準拠
  87 POSIX.1-2001.
  88 .\"O .SH NOTES
  89 .SH 注意
  90 .\"O All open message queues are automatically closed on process termination,
  91 .\"O or upon
  92 .\"O .BR execve (2).
  93 .\"Omotoki: 自動的にクローズされるのは message queue ではなく
  94 .\"Omotoki: message queue descriptor ？ (cf. mq_overview(7))
  95 プロセス終了時、もしくは
  96 .BR execve (2)
  97 実行時に、全てのオープンされたメッセージキューは自動的にクローズされる。
  98 .\"O .SH "SEE ALSO"
  99 .SH 関連項目
 100 .BR mq_getattr (3),
 101 .BR mq_notify (3),
 102 .BR mq_open (3),
 103 .BR mq_receive (3),
 104 .BR mq_send (3),
 105 .BR mq_unlink (3),
 106 .BR mq_overview (7)