1 .\" Copyright 2003 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
4 .\" Distributed under GPL
7 .\" Polished a bit, added a little, aeb
9 .\"*******************************************************************
11 .\" This file was generated with po4a. Translate the source file.
13 .\"*******************************************************************
15 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
16 .\" all rights reserved.
17 .\" Translated Sun Sep 5 20:44:27 JST 2004
18 .\" by Yuichi SATO <ysato444@yahoo.co.jp>
20 .TH SETALIASENT 3 2003\-09\-09 GNU "Linux Programmer's Manual"
22 setaliasent, endaliasent, getaliasent, getaliasent_r, getaliasbyname,
23 getaliasbyname_r \- エイリアスエントリを読み込む
25 \fB#include <aliases.h>\fP
27 \fBvoid setaliasent(void);\fP
29 \fBvoid endaliasent(void);\fP
31 \fBstruct aliasent *getaliasent(void);\fP
33 \fBint getaliasent_r(struct aliasent *\fP\fIresult\fP\fB,\fP
35 \fB char *\fP\fIbuffer\fP\fB, size_t \fP\fIbuflen\fP\fB, struct aliasent **\fP\fIres\fP\fB);\fP
37 \fBstruct aliasent *getaliasbyname(const char *\fP\fIname\fP\fB);\fP
39 \fBint getaliasbyname_r(const char *\fP\fIname\fP\fB, struct aliasent
40 *\fP\fIresult\fP\fB,\fP
42 \fB char *\fP\fIbuffer\fP\fB, size_t \fP\fIbuflen\fP\fB, struct aliasent **\fP\fIres\fP\fB);\fP
44 ネームサービススイッチ (Name Service Switch, NSS) で 利用可能なデータベースの 1 つとして、
45 メールエイリアスを保持するエイリアスデータベースがある。 (どのデータベースがサポートされているかを調べるには、 getent \-\-help
46 を実行すること。) エイリアスデータベースにアクセスするために、 6 つの関数が提供されている。
48 \fBgetaliasent\fP() 関数はエイリアスデータベースから取り出した グループ情報を含む構造体へのポインタを返す。 1
49 回目に関数が呼ばれたときには、最初のエントリを返す; それ以降はその後のエントリを返す。
51 \fBsetaliasent\fP() 関数はファイルポインタをエイリアスデータベースの先頭に巻き戻す。
53 \fBendaliasent\fP() 関数はエイリアスデータベースをクローズする。
55 \fBgetaliasent_r\fP() 関数は上記の関数のリエントラント版である。 要求された構造体は第 1 引き数に格納されるが、
56 プログラマは他の引き数も埋めてやる必要がある。 充分な領域が与えられないと、この関数は失敗する。
58 関数 \fBgetaliasbyname\fP() は name 引き数をとり、エイリアスデータベースを検索する。 エントリは \fIstruct
59 aliasent\fP へのポインタとして返される。
61 \fBgetaliasbyname_r\fP() は上記の関数のリエントラント版である。 要求された構造体は第 2 引き数に格納されるが、
62 プログラマは他の引き数も埋めてやる必要がある。 充分な領域が与えられないと、この関数は失敗する。
64 \fIstruct aliasent\fP は \fI<aliases.h>\fP で定義されている。
69 char *alias_name; /* エイリアス名 */
70 size_t alias_members_len;
71 char **alias_members; /* エイリアス名のリスト */
77 関数 \fBgetaliasent_r\fP() と \fBgetaliasbyname_r\fP() は、エラーの場合に 0 以外の値を返す。
79 デフォルトのエイリアスデータベースは、ファイル \fI/etc/aliases\fP である。 これは \fI/etc/nsswitch.conf\fP
82 このルーチンは glibc 固有のものである。 NeXT システムには同様のルーチンがある。
88 void alias_setent(void);
89 void alias_endent(void);
90 alias_ent *alias_getent(void);
91 alias_ent *alias_getbyname(char *name);
95 以下の例は \fIgcc example.c \-o example\fP でコンパイルできる。 これはエイリアスデータベースにある全ての名前をダンプする。
112 printf("Name: %s\en", al\->alias_name);
115 perror("reading alias");
123 .\" /etc/sendmail/aliases
125 .\" newaliases, postalias
126 \fBgetgrent\fP(3), \fBgetpwent\fP(3), \fBgetspent\fP(3), \fBaliases\fP(5)
128 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
129 である。プロジェクトの説明とバグ報告に関する情報は
130 http://www.kernel.org/doc/man\-pages/ に書かれている。