OSDN Git Service

(split) LDP: Update release pages based on LDP 3.54 release
[linuxjm/LDP_man-pages.git] / release / man3 / realpath.3
index 011fb43..5550310 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright (C) 1999 Andries Brouwer (aeb@cwi.nl)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" Rewritten old page, 990824, aeb@cwi.nl
 .\" 2004-12-14, mtk, added discussion of resolved_path == NULL
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH REALPATH 3 2011\-09\-10 "" "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1998 SHOJI Yasushi all rights reserved.
+.\" Translated 1998-03-22, SHOJI Yasushi <yashi@yashi.com>
+.\" Updated 1999-03-07, Shouichi Saito
+.\" Updated 2003-01-17, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2005-02-27, Akihiro MOTOKI
+.\" Updated 2005-09-06, Akihiro MOTOKI
+.\" Updated 2009-04-24, Akihiro MOTOKI, LDP v3.20
+.\" Updated 2012-05-29, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-03-27, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
+.TH REALPATH 3 2013\-03\-15 "" "Linux Programmer's Manual"
 .SH 名前
 realpath \- 正規化された絶対パス名を返す
 .SH 書式
@@ -81,7 +94,7 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEND
 の場合にもこのエラーが返される。)
 .TP 
 \fBEIO\fP
-ファイルシステムを読むときに、I/Oエラーが起こった。
+An I/O error occurred while reading from the filesystem.
 .TP 
 \fBELOOP\fP
 パス名の変換にあたり、解決すべきシンボリック・リンクの数が多過ぎた。
@@ -95,7 +108,7 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEND
 \fBENOTDIR\fP
 パスのディレクトリ要素が、ディレクトリでない。
 .SH バージョン
-この関数が Linux に登場したのは libc 4.5.21 である。
+Linux では、この関数が登場したのは libc 4.5.21 である。
 .SH 準拠
 4.4BSD, POSIX.1\-2001.
 
@@ -121,9 +134,22 @@ POSIX.1\-2001 では \fIresolved_path\fP が NULL の場合の動作は実装に
 .LP
 (バグの章も参照のこと。)
 .LP
-4.4BSD、Linux、SUSv2 では、返り値は常に絶対パス名である。 Solaris では、 引き数 \fIpath\fP
-が相対パスの場合、返り値が相対パスになることがある。 \fBrealpath\fP()  のプロトタイプ宣言は、 libc4 と libc5 では
-\fI<unistd.h>\fP にあるが、 それ以外の環境ではいずれも \fI<stdlib.h>\fP にある。
+.\"     2012-05-05, According to Casper Dik, the statement about
+.\"     Solaris was not true at least as far back as 1997, and
+.\"     may never have been true.
+.\"
+.\" The 4.4BSD, Linux and SUSv2 versions always return an absolute
+.\" pathname.
+.\" Solaris may return a relative pathname when the
+.\" .I path
+.\" argument is relative.
+\fBrealpath\fP() のプロトタイプ宣言は、 libc4 と libc5 では
+\fI<unistd.h>\fP にあるが、それ以外の環境ではいずれも
+\fI<stdlib.h>\fP にある。
+.SS "GNU による拡張"
+呼び出しが \fBEACCES\fP か \fBENOENT\fP で失敗し \fIresolved_path\fP が NULL
+でない場合、読むことができない、もしくは存在しない \fIpath\fP のディレクトリ要素 (prefix) が \fIresolved_path\fP
+で返される。
 .SH バグ
 この関数の POSIX.1\-2001 版は、設計段階から問題がある。 出力バッファ \fIresolved_path\fP
 の適切なサイズを決定することができないからである。 POSIX.1\-2001 ではバッファ・サイズとして \fBPATH_MAX\fP
@@ -134,12 +160,12 @@ POSIX.1\-2001 では \fIresolved_path\fP が NULL の場合の動作は実装に
 \fIresolved_path\ ==\ NULL\fP の機能を使うと、この設計上の問題を回避することができる。 この機能は POSIX.1\-2001
 では標準化されていないが、 POSIX.1\-2008 では標準化されている。
 .LP
-libc4 ã\81¨ libc5 ã\81®å®\9fè£\85ã\81¯ã\83\90ã\83\83ã\83\95ã\82¡ã\83»ã\82ªã\83¼ã\83\90ã\83¼ã\83\95ã\83­ã\83¼ã\81®å\8f¯è\83½æ\80§ã\82\92æ\8c\81ã\81£ã\81¦ã\81\84ã\82\8b (libc\-5.4.13 で修正されたが)。したがって、
-\fBmount\fP(8)  のような set\-user\-ID されるプログラムでは、 この関数相当の関数を自前で持つ必要がある
+libc4 ã\81¨ libc5 ã\81®å®\9fè£\85ã\81¯ã\83\90ã\83\83ã\83\95ã\82¡ã\83»ã\82ªã\83¼ã\83\90ã\83¼ã\83\95ã\83­ã\83¼ã\81®å\8f¯è\83½æ\80§ã\82\92æ\8c\81ã\81£ã\81¦ã\81\84ã\81\9f (libc\-5.4.13 で修正されたが)。したがって、
+\fBmount\fP(8)  のような set\-user\-ID されるプログラムでは、この関数相当の関数を自前で持つ必要があった
 .SH 関連項目
 \fBreadlink\fP(2), \fBcanonicalize_file_name\fP(3), \fBgetcwd\fP(3), \fBpathconf\fP(3),
 \fBsysconf\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。