OSDN Git Service

(split) LDP: draft snapshot generated from latest ja.po files.
[linuxjm/LDP_man-pages.git] / draft / man2 / fchmodat.2
index 454b0fa..6ff7aca 100644 (file)
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
-.\" Japanese Version Copyright (c) 2006 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated 2006-10-14 by Yuichi SATO <ysato444@yahoo.co.jp>, LDP v2.39
 .\"
-.TH FCHMODAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH FCHMODAT 2 2012\-04\-17 Linux "Linux Programmer's Manual"
 .SH 名前
-.\"O fchmodat \- change permissions of a file relative to a directory \
-.\"O file descriptor
 fchmodat \- ディレクトリファイルディスクリプタから相対的な位置にあるファイルのアクセス権を変更する
-.\"O .SH SYNOPSIS
 .SH 書式
 .nf
-.\"O .B #include <fcntl.h>           /* Definition of AT_* constants */
-.B #include <fcntl.h>           /* AT_* 定数の定義 */
-.B #include <sys/stat.h>
+\fB#include\fP<fcntl.h>\fB           /* AT_* 定数の定義 */\fP
+\fB#include <sys/stat.h>\fP
 .sp
-.BI "int fchmodat(int " dirfd ", const char *" pathname ", mode_t " \
-mode ", int " flags );
+\fBint fchmodat(int \fP\fIdirfd\fP\fB, const char *\fP\fIpathname\fP\fB, mode_t \fP\fImode\fP\fB, int \fP\fIflags\fP\fB);\fP
 .fi
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
-.BR fchmodat ():
+\fBfchmodat\fP():
 .PD 0
 .ad l
 .RS 4
-.TP 4
-.\"O Since glibc 2.10:
+.TP  4
 glibc 2.10 以降:
 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
-.TP
-.\"O Before glibc 2.10:
+.TP 
 glibc 2.10 より前:
 _ATFILE_SOURCE
 .RE
 .ad
 .PD
-.\"O .SH DESCRIPTION
 .SH 説明
-.\"O The
-.\"O .BR fchmodat ()
-.\"O system call operates in exactly the same way as
-.\"O .BR chmod (2),
-.\"O except for the differences described in this manual page.
-.BR fchmodat ()
-システムコールは、この man ページで説明している違いがある以外は、
-.BR chmod (2)
+\fBfchmodat\fP()  システムコールは、この man ページで説明している違いがある以外は、 \fBchmod\fP(2)
 と全く同じように動作する。
 
-.\"O If the pathname given in
-.\"O .I pathname
-.\"O is relative, then it is interpreted relative to the directory
-.\"O referred to by the file descriptor
-.\"O .I dirfd
-.\"O (rather than relative to the current working directory of
-.\"O the calling process, as is done by
-.\"O .BR chmod (2)
-.\"O for a relative pathname).
-.I pathname
-で指定されるパス名が相対パスである場合、
-ファイルディスクリプタ
-.I dirfd
-で参照されるディレクトリからの相対パス名として解釈される
-.RB ( chmod (2)
-では、相対パスは呼び出し元プロセスのカレントワーキングディレクトリからの
-相対パスとなる)。
+\fIpathname\fP で指定されるパス名が相対パスである場合、 ファイルディスクリプタ \fIdirfd\fP
+で参照されるディレクトリからの相対パス名として解釈される (\fBchmod\fP(2)
+では、相対パスは呼び出し元プロセスのカレントワーキングディレクトリからの 相対パスとなる)。
 
-.\"O If
-.\"O .I pathname
-.\"O is relative and
-.\"O .I dirfd
-.\"O is the special value
-.\"O .BR AT_FDCWD ,
-.\"O then
-.\"O .I pathname
-.\"O is interpreted relative to the current working
-.\"O directory of the calling process (like
-.\"O .BR chmod (2)).
-.I pathname
-が相対パスであり、かつ
-.I dirfd
-が特別な値
-.B AT_FDCWD
-である場合、
-.I pathname
-は
-.RB ( chmod (2)
-と同じように) 呼び出し元プロセスの
-カレントワーキングディレクトリからの相対パス名として解釈される。
+\fIpathname\fP が相対パスであり、かつ \fIdirfd\fP が特別な値 \fBAT_FDCWD\fP である場合、 \fIpathname\fP は
+(\fBchmod\fP(2)  と同じように) 呼び出し元プロセスの カレントワーキングディレクトリからの相対パス名として解釈される。
 
-.\"O If
-.\"O .I pathname
-.\"O is absolute, then
-.\"O .I dirfd
-.\"O is ignored.
-.I pathname
-が絶対パスである場合、
-.I dirfd
-は無視される。
+\fIpathname\fP が絶対パスである場合、 \fIdirfd\fP は無視される。
 
-.\"O .I flags
-.\"O can either be 0, or include the following flag:
-.I flags
-は 0 または以下のフラグである。
-.TP
-.B AT_SYMLINK_NOFOLLOW
-.\"O If
-.\"O .I pathname
-.\"O is a symbolic link, do not dereference it:
-.\"O instead operate on the link itself.
-.I pathname
-がシンボリックリンクの場合は、それを辿るのではなく、
-リンク自身に対して (アクセス権の変更の) 操作を行う。
-.\"O This flag is not currently implemented.
+\fIflags\fP は 0 または以下のフラグである。
+.TP 
+\fBAT_SYMLINK_NOFOLLOW\fP
+\fIpathname\fP がシンボリックリンクの場合は、それを辿るのではなく、 リンク自身に対して (アクセス権の変更の) 操作を行う。
 このフラグは現在のところ実装されていない。
-.\"O .SH "RETURN VALUE"
 .SH 返り値
-.\"O On success,
-.\"O .BR fchmodat ()
-.\"O returns 0.
-成功した場合、
-.BR fchmodat ()
-は 0 を返す。
-.\"O On error, \-1 is returned and
-.\"O .I errno
-.\"O is set to indicate the error.
-エラーの場合、\-1 が返されて、
-.I errno
-にはエラーを示す値が設定される。
-.\"O .SH ERRORS
+成功した場合、 \fBfchmodat\fP()  は 0 を返す。 エラーの場合、\-1 が返されて、 \fIerrno\fP にはエラーを示す値が設定される。
 .SH エラー
-.\"O The same errors that occur for
-.\"O .BR chmod (2)
-.\"O can also occur for
-.\"O .BR fchmodat ().
-.BR chmod (2)
-と同じエラーが
-.BR fchmodat ()
-でも起こる。
-.\"O The following additional errors can occur for
-.\"O .BR fchmodat ():
-.BR fchmodat ()
-では、その他に以下のエラーが起こる:
-.TP
-.B EBADF
-.\"O .I dirfd
-.\"O is not a valid file descriptor.
-.I dirfd
-が有効なファイルディスクリプタでない。
-.TP
-.B EINVAL
-.\"O Invalid flag specified in
-.\"O .IR flags .
-.I flags
-に不正なフラグ値が指定された。
-.TP
-.B ENOTDIR
-.\"O .I pathname
-.\"O is relative and
-.\"O .I dirfd
-.\"O is a file descriptor referring to a file other than a directory.
-.I pathname
-が相対パスで、かつ
-.I dirfd
-がディレクトリ以外のファイルを参照するファイルディスクリプタである。
-.TP
-.B ENOTSUP
-.\"O .I flags
-.\"O specified
-.\"O .BR AT_SYMLINK_NOFOLLOW ,
-.\"O which is not supported.
-.I flags
-にサポートされていない値
-.B AT_SYMLINK_NOFOLLOW
-が
-指定された。
-.\"O .SH VERSIONS
+\fBchmod\fP(2)  と同じエラーが \fBfchmodat\fP()  でも起こる。 \fBfchmodat\fP()  では、その他に以下のエラーが起こる:
+.TP 
+\fBEBADF\fP
+\fIdirfd\fP が有効なファイルディスクリプタでない。
+.TP 
+\fBEINVAL\fP
+\fIflags\fP に不正なフラグ値が指定された。
+.TP 
+\fBENOTDIR\fP
+\fIpathname\fP が相対パスで、かつ \fIdirfd\fP がディレクトリ以外のファイルを参照するファイルディスクリプタである。
+.TP 
+\fBENOTSUP\fP
+\fIflags\fP にサポートされていない値 \fBAT_SYMLINK_NOFOLLOW\fP が 指定された。
 .SH バージョン
-.\"O .BR fchmodat ()
-.\"O was added to Linux in kernel 2.6.16.
-.BR fchmodat ()
-は Linux カーネル 2.6.16 で追加された。
-.\"O .SH "CONFORMING TO"
+\fBfchmodat\fP()  は Linux カーネル 2.6.16 で追加された。
 .SH 準拠
-POSIX.1-2008.
-.\"O .SH NOTES
+POSIX.1\-2008.
 .SH 注意
-.\"O See
-.\"O .BR openat (2)
-.\"O for an explanation of the need for
-.\"O .BR fchmodat ().
-.BR fchmodat ()
-が必要な理由については、
-.BR openat (2)
-を参照すること。
-.\"O .SH "SEE ALSO"
+\fBfchmodat\fP() が必要な理由については、 \fBopenat\fP(2) を参照すること。
+
+このマニュアルページは \fBfchmodat\fP() システムコールに対する glibc の
+ラッパー関数が提供するインタフェースについて説明している。
+システムコールの方は \fIflags\fP 引き数は\fI持たない\fP。
 .SH 関連項目
-.BR chmod (2),
-.BR openat (2),
-.BR path_resolution (7),
-.BR symlink (7)
+\fBchmod\fP(2), \fBopenat\fP(2), \fBpath_resolution\fP(7), \fBsymlink\fP(7)