OSDN Git Service
(root)
/
linuxjm
/
LDP_man-pages.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git]
/
release
/
man3
/
getgrouplist.3
diff --git
a/release/man3/getgrouplist.3
b/release/man3/getgrouplist.3
index
c6a262c
..
b8c4095
100644
(file)
--- a/
release/man3/getgrouplist.3
+++ b/
release/man3/getgrouplist.3
@@
-24,115
+24,61
@@
.\" A few pieces remain from an earlier version written in
.\" 2002 by Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
.\" A few pieces remain from an earlier version written in
.\" 2002 by Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
-.\" Japanese Version Copyright (c) 2004 Yuichi SATO
-.\" all rights reserved.
-.\" Translated 2004-08-07, Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated 2008-08-11, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.05
+.\"*******************************************************************
.\"
.\"
-.TH GETGROUPLIST 3 2009-07-03 "GNU" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH GETGROUPLIST 3 2009\-07\-03 GNU "Linux Programmer's Manual"
.SH 名前
getgrouplist \- ユーザが所属するグループのリストを取得する
.SH 書式
.SH 名前
getgrouplist \- ユーザが所属するグループのリストを取得する
.SH 書式
-.B #include <grp.h>
+\fB#include <grp.h>\fP
.sp
.sp
-.BI "int getgrouplist(const char *" user ", gid_t " group ,
+\fBint getgrouplist(const char *\fP\fIuser\fP\fB, gid_t \fP\fIgroup\fP\fB,\fP
.br
.br
-.BI " gid_t *" groups ", int *" ngroups );
+\fB gid_t *\fP\fIgroups\fP\fB, int *\fP\fIngroups\fP\fB);\fP
.sp
.in -4n
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
.in
.sp
-.BR getgrouplist ():
-_BSD_SOURCE
+\fBgetgrouplist\fP(): _BSD_SOURCE
.SH 説明
.SH 説明
-.BR getgrouplist ()
-関数は、グループデータベース
-.RB ( group (5)
-参照) を調べて、
-.I user
-が所属するグループのリストを取得する。
-見つかったグループのうち最大
-.I *ngroups
-個のグループが、配列
-.I groups
+\fBgetgrouplist\fP() 関数は、グループデータベース (\fBgroup\fP(5) 参照) を調べて、 \fIuser\fP
+が所属するグループのリストを取得する。 見つかったグループのうち最大 \fI*ngroups\fP 個のグループが、配列 \fIgroups\fP
に格納されて返される。
に格納されて返される。
-引き数
-.I group
-がグループデータベースに
-.I user
-が所属するグループがなかった場合、
-.BR getgrouplist ()
-が返すグループのリストに引き数
-.I group
-も追加される。
-通常は、この引き数にはユーザ
-.I user
+引き数 \fIgroup\fP がグループデータベースに \fIuser\fP が所属するグループがなかった場合、 \fBgetgrouplist\fP()
+が返すグループのリストに引き数 \fIgroup\fP も追加される。 通常は、この引き数にはユーザ \fIuser\fP
のパスワードレコードに書かれているグループ ID を指定する。
のパスワードレコードに書かれているグループ ID を指定する。
-引き数
-.I ngroups
-は、値渡しと結果の両方に使用される引き数 (value-result argument) であり、
-リターン時には、常に
-.I group
-も含めた
-.I user
-が所属するグループ数が格納される。
-この値は
-.I groups
+引き数 \fIngroups\fP は、値渡しと結果の両方に使用される引き数 (value\-result argument) であり、 リターン時には、常に
+\fIgroup\fP も含めた \fIuser\fP が所属するグループ数が格納される。 この値は \fIgroups\fP
に格納されたグループ数より大きくなる可能性がある。
.SH 返り値
に格納されたグループ数より大きくなる可能性がある。
.SH 返り値
-.I user
-が所属しているグループ数が
-.I *ngroups
-以下の場合、
-.I *ngroups
-の値が返される。
+\fIuser\fP が所属しているグループ数が \fI*ngroups\fP 以下の場合、 \fI*ngroups\fP の値が返される。
-指定されたユーザが
-.I *ngroups
-より多くのグループに所属している場合、
-.BR getgrouplist ()
-は \-1 を返す。
-この場合、
-.I *ngroups
-で返される値を使って、バッファのサイズを変更してから、
-.BR getgrouplist ()
-をもう一度呼び出すことができる。
+指定されたユーザが \fI*ngroups\fP より多くのグループに所属している場合、 \fBgetgrouplist\fP() は \-1 を返す。 この場合、
+\fI*ngroups\fP で返される値を使って、バッファのサイズを変更してから、 \fBgetgrouplist\fP() をもう一度呼び出すことができる。
.SH バージョン
この関数は glibc 2.2.4 から存在する。
.SH 準拠
この関数は非標準である。ほとんどの BSD に存在する。
.SH バグ
.SH バージョン
この関数は glibc 2.2.4 から存在する。
.SH 準拠
この関数は非標準である。ほとんどの BSD に存在する。
.SH バグ
-バージョン 2.3.3 より前の glibc では、
-この関数の実装にはバッファオーバーフローのバグがあり、
-.I user
-が所属するグループ数が
-.I *ngroups
-より多い場合であっても、
-.I user
-が所属するグループの全リストを配列
-.I groups
-に格納してしまう。
+バージョン 2.3.3 より前の glibc では、 この関数の実装にはバッファオーバーフローのバグがあり、 \fIuser\fP が所属するグループ数が
+\fI*ngroups\fP より多い場合であっても、 \fIuser\fP が所属するグループの全リストを配列 \fIgroups\fP に格納してしまう。
.SH 例
.PP
.SH 例
.PP
-以下のプログラムは、一つ目のコマンドライン引き数で指定された名前のユーザ
-が所属するグループのリストを表示する。
-二番目のコマンドライン引き数には、
-.BR getgrouplist ()
-に渡す
-.I ngroups
-の値を指定する。
+以下のプログラムは、一つ目のコマンドライン引き数で指定された名前のユーザ が所属するグループのリストを表示する。 二番目のコマンドライン引き数には、
+\fBgetgrouplist\fP() に渡す \fIngroups\fP の値を指定する。
以下のシェルのセッションはこのプログラムの使用例を示したものである。
.in +4n
.nf
以下のシェルのセッションはこのプログラムの使用例を示したものである。
.in +4n
.nf
-.RB "$" " ./a.out cecilia 0"
+$\fB ./a.out cecilia 0\fP
getgrouplist() returned \-1; ngroups = 3
getgrouplist() returned \-1; ngroups = 3
-.RB "$" " ./a.out cecilia 3"
+$\fB ./a.out cecilia 3\fP
ngroups = 3
16 (dialout)
33 (video)
ngroups = 3
16 (dialout)
33 (video)
@@
-156,7
+102,7
@@
main(int argc, char *argv[])
struct group *gr;
if (argc != 3) {
struct group *gr;
if (argc != 3) {
- fprintf(stderr, "Usage: %s <user> <ngroups>\
\
n", argv[0]);
+ fprintf(stderr, "Usage: %s <user> <ngroups>\
e
n", argv[0]);
exit(EXIT_FAILURE);
}
exit(EXIT_FAILURE);
}
@@
-179,28
+125,24
@@
main(int argc, char *argv[])
/* Retrieve group list */
if (getgrouplist(argv[1], pw\->pw_gid, groups, &ngroups) == \-1) {
/* Retrieve group list */
if (getgrouplist(argv[1], pw\->pw_gid, groups, &ngroups) == \-1) {
- fprintf(stderr, "getgrouplist() returned \-1; ngroups = %d\
\
n",
+ fprintf(stderr, "getgrouplist() returned \-1; ngroups = %d\
e
n",
ngroups);
exit(EXIT_FAILURE);
}
/* Display list of retrieved groups, along with group names */
ngroups);
exit(EXIT_FAILURE);
}
/* Display list of retrieved groups, along with group names */
- fprintf(stderr, "ngroups = %d\
\
n", ngroups);
+ fprintf(stderr, "ngroups = %d\
e
n", ngroups);
for (j = 0; j < ngroups; j++) {
printf("%d", groups[j]);
gr = getgrgid(groups[j]);
if (gr != NULL)
printf(" (%s)", gr\->gr_name);
for (j = 0; j < ngroups; j++) {
printf("%d", groups[j]);
gr = getgrgid(groups[j]);
if (gr != NULL)
printf(" (%s)", gr\->gr_name);
- printf("\
\
n");
+ printf("\
e
n");
}
exit(EXIT_SUCCESS);
}
.fi
.SH 関連項目
}
exit(EXIT_SUCCESS);
}
.fi
.SH 関連項目
-.BR getgroups (2),
-.BR setgroups (2),
-.BR getgrent (3),
-.BR group (5),
-.BR passwd (5)
+\fBgetgroups\fP(2), \fBsetgroups\fP(2), \fBgetgrent\fP(3), \fBgroup\fP(5), \fBpasswd\fP(5)