properties_free(3)

properties_read, propery_find, properties_free − 単純なプロパティリストを ASCII から作成する関数

システムユーティリティライブラリ (libutil, −lutil)

#include <sys/types.h>
#include <libutil.h>

properties

properties_read(int fd);

char *

property_find(properties list, const char *name);

void

properties_free(properties list);

解説

typedef struct _properties {

struct _properties *next;

char *name;

char *value;

} *properties;

関数 properties_read() は、 fd で渡されたファイル記述子から名前と値のペア を読み込み、ファイルの内容が適切に分析されたものとして新しいプロパティリ ストのヘッドを戻します。エラーが発生した場合は NULL が返されます。返され る値は、最大長 PROPERTY_MAX_VALUE バイトまでです。

property_find() は、 name という名前のプロパティの関連値ストリングを戻し ます。このプロパティが見つからない場合は NULL を戻します。

properties_free() は、 properties_read() が戻した構造体が必要なくなった場 合にそれを解放します。

ファイルの各プロパティは、 name = value というフォーマットになっていると 想定されます。 name は英数字文字列 (および ‘=’ 以外の特殊文字) です。 value は、改行文字で終わる、テキストの任意のストリングです。改行する場合 は、値全体を { } で囲む必要があります。# か ; で始まる行はコメントとみな されて無視されます。

auth_getval(3)

単純です。

Jordan Hubbard

FreeBSD 10.0 October 7, 1998 FreeBSD 10.0