.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining
.\" a copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of the X Consortium shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from the X Consortium.
.\"
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by
.\" Digital Equipment Corporation
.\"
.\" Portions Copyright \(co 1990, 1991 by
.\" Tektronix, Inc.
.\"
.\" Permission to use, copy, modify and distribute this documentation for
.\" any purpose and without fee is hereby granted, provided that the above
.\" copyright notice appears in all copies and that both that copyright notice
.\" and this permission notice appear in all copies, and that the names of
.\" Digital and Tektronix not be used in in advertising or publicity pertaining
.\" to this documentation without specific, written prior permission.
.\" Digital and Tektronix makes no representations about the suitability
.\" of this documentation for any purpose.
.\" It is provided ``as is'' without express or implied warranty.
.\" 
.\" Copyright (c) 1998, 2001 The X Japanese Documentation Project.
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\" 
.\" X Window System is a trademark of The Open Group.
.\"
.\" Translated Mon Oct 5 22:42:37 JST 1998
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Corrected by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Sat Sep 22 17:28:44 JST 2001 for XFree86 4.1.0
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/doc/man/X11/XAddHost.man,v 1.2 2001/01/27 18:19:56 dawes Exp $
.\"
.ds xT X Toolkit Intrinsics \- C Language Interface
.ds xW Athena X Widgets \- C Language X Toolkit Interface
.ds xL Xlib \- C Language X Interface
.ds xC Inter-Client Communication Conventions Manual
.na
.de Ds
.nf
.\\$1D \\$2 \\$1
.ft 1
.\".ps \\n(PS
.\".if \\n(VS>=40 .vs \\n(VSu
.\".if \\n(VS<=39 .vs \\n(VSp
..
.de De
.ce 0
.if \\n(BD .DF
.nr BD 0
.in \\n(OIu
.if \\n(TM .ls 2
.sp \\n(DDu
.fi
..
.de FD
.LP
.KS
.TA .5i 3i
.ta .5i 3i
.nf
..
.de FN
.fi
.KE
.LP
..
.de IN		\" send an index entry to the stderr
..
.de C{
.KS
.nf
.D
.\"
.\"	choose appropriate monospace font
.\"	the imagen conditional, 480,
.\"	may be changed to L if LB is too
.\"	heavy for your eyes...
.\"
.ie "\\*(.T"480" .ft L
.el .ie "\\*(.T"300" .ft L
.el .ie "\\*(.T"202" .ft PO
.el .ie "\\*(.T"aps" .ft CW
.el .ft R
.ps \\n(PS
.ie \\n(VS>40 .vs \\n(VSu
.el .vs \\n(VSp
..
.de C}
.DE
.R
..
.de Pn
.ie t \\$1\fB\^\\$2\^\fR\\$3
.el \\$1\fI\^\\$2\^\fP\\$3
..
.de ZN
.ie t \fB\^\\$1\^\fR\\$2
.el \fI\^\\$1\^\fP\\$2
..
.de hN
.ie t <\fB\\$1\fR>\\$2
.el <\fI\\$1\fP>\\$2
..
.de NT
.ne 7
.ds NO Note
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
.ie n .sp
.el .sp 10p
.TB
.ce
\\*(NO
.ie n .sp
.el .sp 5p
.if '\\$1'C' .ce 99
.if '\\$2'C' .ce 99
.in +5n
.ll -5n
.R
..
.		\" Note End -- doug kraft 3/85
.de NE
.ce 0
.in -5n
.ll +5n
.ie n .sp
.el .sp 10p
..
.ny0
.TH XAddHost 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS"
.SH 名前
.\"0 XAddHost, XAddHosts, XListHosts, XRemoveHost, XRemoveHosts, XSetAccessControl, XEnableAccessControl, XDisableAccessControl, XHostAddress \- control host access and host control structure
XAddHost, XAddHosts, XListHosts, XRemoveHost, XRemoveHosts, XSetAccessControl, XEnableAccessControl, XDisableAccessControl, XHostAddress \- ホストのアクセス制御とホスト制御構造体
.SH 書式
XAddHost\^(\^\fIdisplay\fP, \fIhost\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      XHostAddress *\fIhost\fP\^;	
.LP
XAddHosts\^(\^\fIdisplay\fP, \fIhosts\fP, \fInum_hosts\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      XHostAddress *\fIhosts\fP\^;
.br
      int \fInum_hosts\fP\^;
.LP
XHostAddress *XListHosts\^(\^\fIdisplay\fP, \fInhosts_return\fP, \fIstate_return\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      int *\fInhosts_return\fP\^;
.br
      Bool *\fIstate_return\fP\^;
.LP
XRemoveHost\^(\^\fIdisplay\fP, \fIhost\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      XHostAddress *\fIhost\fP\^;
.LP
XRemoveHosts\^(\^\fIdisplay\fP, \fIhosts\fP, \fInum_hosts\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      XHostAddress *\fIhosts\fP\^;
.br
      int \fInum_hosts\fP\^;
.LP
XSetAccessControl\^(\^\fIdisplay\fP, \fImode\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      int \fImode\fP\^;
.LP
XEnableAccessControl\^(\^\fIdisplay\fP\^)
.br
      Display *\fIdisplay\fP\^;
.LP
XDisableAccessControl\^(\^\fIdisplay\fP\^)
.br
      Display *\fIdisplay\fP\^;
.SH 引き数
.IP \fIdisplay\fP 1i
.\"0 Specifies the connection to the X server.
X サーバへの接続を指定する。
.ds Ho added or removed
.IP \fIhost\fP 1i
.\"0 Specifies the host that is to be \*(Ho.
追加、削除するホストを 1 つ指定する。
.ds Ho added or removed
.IP \fIhosts\fP 1i
.\"0 Specifies each host that is to be \*(Ho.
追加、削除するホストを複数個指定する。
.IP \fImode\fP 1i
.\"0 Specifies the mode.
モードを指定する。
.\"0 You can pass
.\"0 .ZN EnableAccess
.\"0 or
.\"0 .ZN DisableAccess .
.ZN EnableAccess
あるいは
.ZN DisableAccess
を指定できる。
.IP \fInhosts_return\fP 1i
.\"0 Returns the number of hosts currently in the access control list.
現在アクセス制御リストに入っているホスト数が返される。
.IP \fInum_hosts\fP 1i
.\"0 Specifies the number of hosts.
ホストの数を指定する。
.IP \fIstate_return\fP 1i
.\"0 Returns the state of the access control.
アクセス制御の状態が返される。
.SH 説明
.\"0 The
.\"0 .ZN XAddHost
.\"0 function adds the specified host to the access control list for that display.
関数
.ZN XAddHost
は指定したホストをディスプレイのアクセス制御リストに追加する。
.\"0 The server must be on the same host as the client issuing the command, or a
.\"0 .ZN BadAccess
.\"0 error results.
サーバのホストはこのコマンドを発行したクライアントのホストと同じでなけ
ればならない。そうでない場合はエラー
.ZN BadAccess
となる。
.LP
.\"0 .ZN XAddHost
.\"0 can generate
.\"0 .ZN BadAccess
.\"0 and
.\"0 .ZN BadValue
.\"0 errors.
.ZN XAddHost
はエラー
.ZN BadAccess ,
.ZN BadValue
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XAddHosts
.\"0 function adds each specified host to the access control list for that display.
関数
.ZN XAddHosts
は、指定した複数個のホストをディスプレイのアクセス制御リストに追加する。
.\"0 The server must be on the same host as the client issuing the command, or a
.\"0 .ZN BadAccess
.\"0 error results.
サーバのホストは、このコマンドを発行したクライアントのホストと同じでな
ければならない。そうでない場合、エラー
.ZN BadAccess
となる。
.LP
.\"0 .ZN XAddHosts
.\"0 can generate
.\"0 .ZN BadAccess
.\"0 and
.\"0 .ZN BadValue
.\"0 errors.
.ZN XAddHosts
はエラー
.ZN BadAccess ,
.ZN BadValue
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XListHosts
.\"0 function returns the current access control list as well as whether the use 
.\"0 of the list at connection setup was enabled or disabled.
関数
.ZN XListHosts
は現在のアクセス制御リストを返す。これと同時に、接続のセットアップ時に
リストの使用が有効であったかどうかを返す。
.\"0 .ZN XListHosts
.\"0 allows a program to find out what machines can make connections.
.ZN XListHosts
を使えば、プログラムはどのホストが接続可能かを知ることができる。
.\"0 It also returns a pointer to a list of host structures that
.\"0 were allocated by the function. 
この関数は割り当てたホスト構造体のリストへのポインタを返す。
.\"0 When no longer needed,
.\"0 this memory should be freed by calling
.\"0 .ZN XFree .
リストが不要になれば、
.ZN XFree
を使ってこのメモリ領域を解放すること。
.LP
.\"0 The
.\"0 .ZN XRemoveHost
.\"0 function removes the specified host from the access control list 
.\"0 for that display.
関数
.ZN XRemoveHost
は、指定したホストをディスプレイのアクセス制御リストから削除する。
.\"0 The server must be on the same host as the client process, or a
.\"0 .ZN BadAccess
.\"0 error results.
サーバとクライアントプロセスは同じホスト上になければならない。そうでな
い場合、エラー
.ZN BadAccess
となる。
.\"0 If you remove your machine from the access list,
.\"0 you can no longer connect to that server,
.\"0 and this operation cannot be reversed unless you reset the server.
自分のマシンをアクセスリストから削除すると、それ以降サーバに接続できな
くなってしまう。サーバをリセットしない限り元の状態に戻すことはできない。
.LP
.\"0 .ZN XRemoveHost
.\"0 can generate
.\"0 .ZN BadAccess
.\"0 and
.\"0 .ZN BadValue
.\"0 errors.
.ZN XRemoveHost
はエラー
.ZN BadAccess ,
.ZN BadValue
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XRemoveHosts
.\"0 function removes each specified host from the access control list for that 
.\"0 display.  
関数
.ZN XRemoveHosts
は、指定した複数個のホストをディスプレイのアクセス制御リストから削除する。
.\"0 The X server must be on the same host as the client process, or a
.\"0 .ZN BadAccess
.\"0 error results.
サーバとクライアントプロセスは同じホスト上になければならない。そうでな
い場合、エラー
.ZN BadAccess
となる。
.\"0 If you remove your machine from the access list, 
.\"0 you can no longer connect to that server,
.\"0 and this operation cannot be reversed unless you reset the server.
自分のマシンをアクセスリストから削除すると、それ以降サーバに接続できな
くなってしまう。サーバをリセットしない限り元の状態に戻すことはできない。
.LP
.\"0 .ZN XRemoveHosts
.\"0 can generate
.\"0 .ZN BadAccess
.\"0 and
.\"0 .ZN BadValue
.\"0 errors.
.ZN XRemoveHosts
はエラー
.ZN BadAccess ,
.ZN BadValue
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XSetAccessControl
.\"0 function either enables or disables the use of the access control list 
.\"0 at each connection setup.
関数
.ZN XSetAccessControl
は接続の設定の時に、アクセス制御リストの使用を有効あるいは無効にする。
.LP
.\"0 .ZN XSetAccessControl
.\"0 can generate
.\"0 .ZN BadAccess
.\"0 and
.\"0 .ZN BadValue 
.\"0 errors.
.ZN XSetAccessControl
はエラー
.ZN BadAccess ,
.ZN BadValue
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XEnableAccessControl
.\"0 function enables the use of the access control list at each connection setup.
関数
.ZN XEnableAccessControl
は、接続の設定の時にアクセス制御リストの使用を有効にする。
.LP
.\"0 .ZN XEnableAccessControl
.\"0 can generate a
.\"0 .ZN BadAccess 
.\"0 error.
.ZN XEnableAccessControl
はエラー
.ZN BadAccess
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XDisableAccessControl
.\"0 function disables the use of the access control list at each connection setup.
関数
.ZN XDisableAccessControl
は接続の設定時にアクセス制御リストの使用を無効にする。
.LP
.\"0 .ZN XDisableAccessControl
.\"0 can generate a
.\"0 .ZN BadAccess 
.\"0 error.
.ZN XDisableAccessControl
はエラー
.ZN BadAccess
を起こすことがある。
.SH 構造体
.\"0 The
.\"0 .ZN XHostAddress
.\"0 structure contains:
.ZN XHostAddress
構造体の内容を示す。
.LP
.Ds 0
.TA .5i 3i
.ta .5i 3i
typedef struct {
	int family;	
	int length;	
	char *address;	
} XHostAddress;
.De
.LP
.\"0 The family member specifies which protocol address family to use 
.\"0 (for example, TCP/IP or DECnet) and can be
.\"0 .ZN FamilyInternet ,
.\"0 .ZN FamilyDECnet ,
.\"0 or
.\"0 .ZN FamilyChaos .
family メンバは、使用するプロトコルアドレスファミリ(例えば TCP/IP や 
DECnet)を指定する。このメンバには
.ZN FamilyInternet ,
.ZN FamilyDECnet ,
.ZN FamilyChaos
のいずれかを指定する。
.\"0 The length member specifies the length of the address in bytes.
length メンバはアドレスの長さをバイト数で指定する。
.\"0 The address member specifies a pointer to the address.
address メンバはアドレスへのポインタを指定する。
.SH 返り値
.TP 1i
.ZN BadAccess
.\"0 A client attempted
.\"0 to modify the access control list from other than the local
.\"0 (or otherwise authorized) host.
クライアントがローカルホスト(あるいは認められたホスト)以外からアクセス
制御リストを変更しようとした。
.TP 1i
.ZN BadValue
.\"0 Some numeric value falls outside the range of values accepted by the request.
.\"0 Unless a specific range is specified for an argument, the full range defined
.\"0 by the argument's type is accepted.  Any argument defined as a set of
.\"0 alternatives can generate this error.
数値の中にリクエストの許容範囲を越えるものがある。引き数に対して特定の範
囲が指定されない限り、引き数の型の全ての範囲が許される。選択肢として定義
された引き数は、このエラーを起こすことがある。
.SH 関連項目
XFree(3X11)
.br
\fI\*(xL\fP