GETHOSTNAME
Section: C Library Functions (3)
索引
jman
BSD mandoc
BSD 4.2
索引
名称
gethostname
sethostname
- 現在のホストの名前の取得 / 設定
索引
ライブラリ
Lb libc
索引
書式
In unistd.h
Ft int
Fn gethostname char *name int namelen
Ft int
Fn sethostname const char *name int namelen
索引
解説
Fn gethostname
は
Fn sethostname
によって前に設定された、現在のプロセッサの標準のホスト名を返します。パラメータ
Fa namelen
は
Fa name
配列のサイズを指定します。
使用できる空間が不十分な場合を除いて、返される名前はヌルで終わります。
Fn sethostname
は、長さ
Fa namelen
の
Fa name
という、ホストマシン名を設定します。
この呼び出しはスーパユーザに限定され、
通常はシステムのブートストラップ時にだけ実行されます。
索引
戻り値
Rv -std
索引
エラー
これらの呼び出しによって、次のエラーが返る場合があります。
- Bq Er EFAULT
-
Fa name
または
Fa namelen
パラメータが、無効なアドレスを与えました。
- Bq Er EPERM
-
呼び出し元がホスト名を設定しようとしましたが、
スーパユーザではありませんでした。
索引
関連項目
gethostid(3),
sysctl(3)
索引
バグ
ホスト名の長さが MAXHOSTNAMELEN (
Ao Pa sys/param.h Ac
から取得) 文字に制限されてあり、
現在の設定は 256 文字です。
この文字には末尾の
ヌル
も含みます。
索引
歴史
Fn gethostname
関数は、
BSD 4.2
ではじめて登場しました。
索引
Index
- 名称
-
- ライブラリ
-
- 書式
-
- 解説
-
- 戻り値
-
- エラー
-
- 関連項目
-
- バグ
-
- 歴史
-
Time: 07:06:52 GMT, January 12, 2009