tail head cat sleep
QR code linking to this page

manページ  — GETHOSTNAME

名称

gethostname, sethostname – 現在のホストの名前の取得 / 設定

内容

ライブラリ

Standard C Library (libc, -lc)

書式

#include <unistd.h>

int
gethostname(char *name, int namelen);

int
sethostname(const char *name, int namelen);

解説

gethostname()sethostname() によって前に設定された、現在のプロセッサの標準のホスト名を返します。パラメータ namelenname 配列のサイズを指定します。 使用できる空間が不十分な場合を除いて、返される名前はヌルで終わります。

sethostname() は、長さ namelenname という、ホストマシン名を設定します。 この呼び出しはスーパユーザに限定され、 通常はシステムのブートストラップ時にだけ実行されます。

戻り値

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

これらの呼び出しによって、次のエラーが返る場合があります。
[EFAULT]
  name または namelen パラメータが、無効なアドレスを与えました。
[EPERM]
  呼び出し元がホスト名を設定しようとしましたが、 スーパユーザではありませんでした。

関連項目

gethostid(3), sysctl(3)

バグ

ホスト名の長さが MAXHOSTNAMELEN ( < sys/param.h > から取得) 文字に制限されてあり、 現在の設定は 256 文字です。 この文字には末尾の ヌル も含みます。

歴史

gethostname() 関数は、 BSD 4.2 ではじめて登場しました。

BSD 4.2 GETHOSTNAME (3) June 4, 1993

tail head cat sleep
QR code linking to this page


このマニュアルページサービスについてのご意見は Ben Bullock にお知らせください。 Privacy policy.

The “N” in NFS stands for Not, or Need, or perhaps Nightmare
— Harry Spencer