aboutsummaryrefslogtreecommitdiff
path: root/documentation/manual-pages/ja/man3/gethostname.3
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/manual-pages/ja/man3/gethostname.3')
-rw-r--r--documentation/manual-pages/ja/man3/gethostname.399
1 files changed, 99 insertions, 0 deletions
diff --git a/documentation/manual-pages/ja/man3/gethostname.3 b/documentation/manual-pages/ja/man3/gethostname.3
new file mode 100644
index 0000000000..6255017150
--- /dev/null
+++ b/documentation/manual-pages/ja/man3/gethostname.3
@@ -0,0 +1,99 @@
+.\" Copyright (c) 1983, 1991, 1993
+.\" The Regents of the University of California. All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\" must display the following acknowledgement:
+.\" This product includes software developed by the University of
+.\" California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" @(#)gethostname.3 8.1 (Berkeley) 6/4/93
+.\" %FreeBSD: src/lib/libc/gen/gethostname.3,v 1.5.2.5 2001/12/14 18:33:51 ru Exp %
+.\"
+.\" $FreeBSD$
+.Dd June 4, 1993
+.Dt GETHOSTNAME 3
+.Os BSD 4.2
+.Sh 名称
+.Nm gethostname ,
+.Nm sethostname
+.Nd 現在のホストの名前の取得 / 設定
+.Sh ライブラリ
+.Lb libc
+.Sh 書式
+.In unistd.h
+.Ft int
+.Fn gethostname "char *name" "int namelen"
+.Ft int
+.Fn sethostname "const char *name" "int namelen"
+.Sh 解説
+.Fn gethostname
+は
+.Fn sethostname
+によって前に設定された、現在のプロセッサの標準のホスト名を返します。パラメータ
+.Fa namelen
+は
+.Fa name
+配列のサイズを指定します。
+使用できる空間が不十分な場合を除いて、返される名前はヌルで終わります。
+.Pp
+.Fn sethostname
+は、長さ
+.Fa namelen
+の
+.Fa name
+という、ホストマシン名を設定します。
+この呼び出しはスーパユーザに限定され、
+通常はシステムのブートストラップ時にだけ実行されます。
+.Sh 戻り値
+.Rv -std
+.Sh エラー
+これらの呼び出しによって、次のエラーが返る場合があります。
+.Bl -tag -width Er
+.It Bq Er EFAULT
+.Fa name
+または
+.Fa namelen
+パラメータが、無効なアドレスを与えました。
+.It Bq Er EPERM
+呼び出し元がホスト名を設定しようとしましたが、
+スーパユーザではありませんでした。
+.El
+.Sh 関連項目
+.Xr gethostid 3 ,
+.Xr sysctl 3
+.Sh バグ
+ホスト名の長さが MAXHOSTNAMELEN (
+.Ao Pa sys/param.h Ac
+から取得) 文字に制限されてあり、
+現在の設定は 256 文字です。
+この文字には末尾の
+.Dv ヌル
+も含みます。
+.Sh 歴史
+.Fn gethostname
+関数は、
+.Bx 4.2
+ではじめて登場しました。