.\" Translated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
.\" Updated 2013-07-17, Akihiro MOTOKI <amotoki@gmail.com>
.\"
-.TH PTHREAD_SETNAME_NP 3 2013\-06\-21 Linux "Linux Programmer's Manual"
+.TH PTHREAD_SETNAME_NP 3 2014\-05\-28 Linux "Linux Programmer's Manual"
.SH 名前
pthread_setname_np, pthread_getname_np \- スレッド名の設定/取得を行う
.SH 書式
\fB#include <pthread.h>\fP
\fBint pthread_setname_np(pthread_t \fP\fIthread\fP\fB, const char *\fP\fIname\fP\fB);\fP
\fBint pthread_getname_np(pthread_t \fP\fIthread\fP\fB,\fP
-\fB const char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP
+\fB char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP
.fi
.sp
\fI\-pthread\fP を付けてコンパイルとリンクを行う。
.SH 説明
デフォルトでは、 \fBpthread_create\fP() で作成されたすべてのスレッドはプログラム名を継承する。
\fBpthread_setname_np\fP() 関数を使うとスレッドに固有の名前を設定することができる。
-ã\82¹ã\83¬ã\83\83ã\83\89å\9bºæ\9c\89ã\81®å\90\8då\89\8dã\81¯ã\83\9eã\83«ã\83\81ã\82¹ã\83¬ã\83\83ã\83\89ã\83»ã\82¢ã\83\97ã\83ªã\82±ã\83¼ã\82·ã\83§ã\83³ã\81®ã\83\87ã\83\90ã\83\83ã\82°ã\81«ä¾¿å\88©ã\81§ã\81\82ã\82\8bã\80\82 ã\82¹ã\83¬ã\83\83ã\83\89å\90\8dã\81¯æ\84\8få\91³ã\81®ã\81\82ã\82\8b C è¨\80èª\9eã\81®æ\96\87å\97å\88\97ã\81§ã\81\82ã\82\8bã\80\82 ã\81\9dã\81®é\95·ã\81\95ã\81¯ 16
-文字に限定されており、 終端の NULL バイト (\(aq\e0\(aq) も 16 文字に含まれる。 \fIthread\fP
+スレッド固有の名前はマルチスレッドアプリケーションのデバッグに便利である。 スレッド名は意味のある C 言語の文字列である。 その長さは 16
+文字に限定されており、 終端のヌルバイト (\(aq\e0\(aq) も 16 文字に含まれる。 \fIthread\fP
引き数で名前を変更するスレッドを指定する。 \fIname\fP には新しい名前を指定する。
\fBpthread_getname_np\fP() 関数を使うと、 スレッド名を取得することができる。 \fIthread\fP
-引き数は名前を取得するスレッドを指定する。 バッファ \fIname\fP はスレッド名を返すのに使用される。 \fIlen\fP には \fIname\fP
-ã\81®å¤§ã\81\8dã\81\95ã\82\92ã\83\90ã\82¤ã\83\88ã\81§æ\8c\87å®\9aã\81\99ã\82\8bã\80\82 \fIname\fP ã\81§æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fã\83\90ã\83\83ã\83\95ã\82¡ã\81®å¤§ã\81\8dã\81\95ã\81¯æ\9c\80ä½\8eã\81§ã\82\82 16 æ\96\87å\97ã\81¨ã\81\99ã\81¹ã\81\8dã\81§ã\81\82ã\82\8bã\80\82 å\87ºå\8a\9bã\83\90ã\83\83ã\83\95ã\82¡ã\81«è¿\94ã\81\95ã\82\8cã\81\9fã\82¹ã\83¬ã\83\83ã\83\89å\90\8dã\81¯
-NULL 終端される。
+引き数は名前を取得するスレッドを指定する。 バッファー \fIname\fP はスレッド名を返すのに使用される。 \fIlen\fP には \fIname\fP
+ã\81®å¤§ã\81\8dã\81\95ã\82\92ã\83\90ã\82¤ã\83\88ã\81§æ\8c\87å®\9aã\81\99ã\82\8bã\80\82 \fIname\fP ã\81§æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81®å¤§ã\81\8dã\81\95ã\81¯æ\9c\80ä½\8eã\81§ã\82\82 16 æ\96\87å\97ã\81¨ã\81\99ã\81¹ã\81\8dã\81§ã\81\82ã\82\8bã\80\82
+出力バッファーに返されたスレッド名はヌル終端される。
.SH 返り値
成功すると、これらの関数は 0 を返す。
エラーの場合、0 以外のエラー番号を返す。
\fBpthread_getname_np\fP() は以下のエラーで失敗する場合がある。
.TP
\fBERANGE\fP
-\fIname\fP と \fIlen\fP で指定されたバッファが、 スレッド名を格納するには短かすぎる。
+\fIname\fP ã\81¨ \fIlen\fP ã\81§æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81\8cã\80\81 ã\82¹ã\83¬ã\83\83ã\83\89å\90\8dã\82\92æ ¼ç´\8dã\81\99ã\82\8bã\81«ã\81¯ç\9fã\81\8bã\81\99ã\81\8eã\82\8bã\80\82
.PP
\fI/proc/self/task/[tid]/comm\fP のオープンに失敗した場合、 これらの関数は \fBopen\fP(2)
で説明されているエラーのいずれかで失敗する。
.nh
\fBprctl\fP(2), \fBpthread_create\fP(3), \fBpthreads\fP(7)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.63 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
