EN JA
OPENPAM_READLINE(3)
OPENPAM_READLINE(3) FreeBSD Library Functions Manual OPENPAM_READLINE(3)

名称

openpam_readlineファイルから 1 行を読み込む

ライブラリ

Pluggable Authentication Module Library (libpam, -lpam)

書式

#include < sys/types.h>
#include < stdio.h>
#include < security/pam_appl.h>
#include < security/openpam.h>

char *
openpam_readline( FILE *f, int *lineno, size_t *lenp);

解説

この関数は、廃止予定で、されなる警告なしで将来のリリースで削除されるかもしれません。 openpam_readlinev() 関数は、同様の結果に達成するために使用することができます。

openpam_readline() 関数は、ファイルから 1 行を読み込む、 malloc(3) で割り付けられたヌル文字で終るバッファ中にそれを返します。

openpam_readline() 関数は、それを読み込むデータである量の処理を実行します:

  • (ハッシュサイン (訳注: #) で導入される) コメントは、取り除かれます。
  • 空白行は、無視されます。
  • 行末がバックスラッシュであるなら、バックスラッシュは、取り除かれ、次の行が追加されます。

linenoNULL でないなら、改行文字が読み込まれるときはいつも、それが指す整数変数が増加されます。

lenpNULL でないなら、行の (終端のヌル文字を含まない) 長さは、それを指す変数に格納されます。

呼び出し側は、それを free(3) に渡すことによって返されたバッファを解放する責任があります。

戻り値

openpam_readline() 関数は、失敗すれば、 NULL を返します。

規格

openpam_readline() 関数は、OpenPAM の拡張です。

作者

openpam_readlinev() 関数とこのマニュアルページは、 FreeBSD プロジェクトのために DARPA CHATS 研究プログラムの一環として DARPA/SPAWAR 規約 N66001-01-C-8035 (“CBOSS”) の下で ThinkSec AS と Network Associates Laboratories, the Security Research Division of Network Associates, Inc. によって開発されました。

OpenPAM ライブラリは、 Dag-Erling Smørgrav <des@des.no>によって保守されています。

September 7, 2013 FreeBSD