XAddHost(3X11)

名前
XAddHost, XAddHosts, XListHosts, XRemoveHost, XRemoveHosts, XSetAccessControl, XEnableAccessControl, XDisableAccessControl, XHostAddress - ホストのアクセス制御とホスト制御構造体

書式
XAddHost(display, host)
      Display *display;
      XHostAddress *host;

XAddHosts(display, hosts, num_hosts)
      Display *display;
      XHostAddress *hosts;
      int num_hosts;

XHostAddress *XListHosts(display, nhosts_return, state_return)
      Display *display;
      int *nhosts_return;
      Bool *state_return;

XRemoveHost(display, host)
      Display *display;
      XHostAddress *host;

XRemoveHosts(display, hosts, num_hosts)
      Display *display;
      XHostAddress *hosts;
      int num_hosts;

XSetAccessControl(display, mode)
      Display *display;
      int mode;

XEnableAccessControl(display)
      Display *display;

XDisableAccessControl(display)
      Display *display;

引き数

display
    X サーバへの接続を指定。

host
    追加、削除するホストを1つ指定。

hosts
    追加、削除するホストを複数指定。

mode
    モードを指定。 あるいは を指定する。

nhosts_return
    現在アクセス制御リストに入っているホスト数が返される。

num_hosts
    ホスト数を指定。

state_return
    アクセス制御の状態が返される。

説明
関数 は指定したホストをディスプレイのアクセス制御リストに追加する。 サーバのホストは、このコマンドを発行したクライアントのホストと同じでな ければならない。そうでない場合、エラー となる。

はエラー を起こすことがある。

関数 は、指定した複数のホストをディスプレイのアクセス制御リストに追加する。 サーバのホストは、このコマンドを発行したクライアントのホストと同じでな ければならない。そうでない場合、エラー となる。

はエラー を起こすことがある。

関数 は現在のアクセス制御リストを返す。同時に、接続のセットアップ時にリスト の使用が有効であったかを返す。 を使えば、プログラムはどのホストが接続可能かを知ることができる。 この関数はアロケートしたホスト構造体のリストへのポインタを返す。 リストが不要になれば、 を使ってこのメモリ領域を解放すること。

関数 は、指定したホストをディスプレイのアクセス制御リストから削除する。 サーバとクライアントプロセスは同じホスト上になければならない。そうでな い場合、エラー となる。 自分のマシンをアクセスリストから削除すると、それ以降サーバに接続できな くなってしまう。サーバをリセットしない限り、この逆の操作はできない。

はエラー を起こすことがある。

関数 は、指定した複数のホストをディスプレイのアクセス制御リストから削除する。 サーバとクライアントプロセスは同じホスト上になければならない。そうでな い場合、エラー となる。 自分のマシンをアクセスリストから削除すると、それ以降サーバに接続できな くなってしまう。サーバをリセットしない限り、この逆の操作はできない。

はエラー を起こすことがある。

関数 は接続のセットアップの時に、アクセス制御リストの使用を有効あるいは無効 にする。

はエラー を起こすことがある。

関数 は、接続のセットアップの時にアクセス制御リストの使用を有効にする。

はエラー を起こすことがある。

関数 は、接続のセットアップ時にアクセス制御リストの使用を無効にする。

はエラー を起こすことがある。

構造体
構造体の内容を示す。

typedef struct {
    int family;    /* 例えば、FamilyInternet がセットされる */
     int length;    /* アドレスの長さのバイト数 */
     char *address;    /* アドレスがある場所を指すポインタ */
} XHostAddress;

family メンバは、使用するプロトコルアドレスファミリ(例えば TCP/IP や DECnet)を指定する。このメンバには のいずれかを指定する。 length メンバはアドレスの長さをバイト数で指定する。 address メンバはアドレスへのポインタを指定する。

返り値

クライアントがローカルホスト(あるいは認められたホスト)以外からアクセス
    制御リストを変更しようとした。

数値の中にリクエストの許容範囲を越えるものがある。引き数に対して特定の範
    囲が指定されない限り、引き数の型の全ての範囲が許される。選択肢として定義 された引き数は、このエラーを起こすことがある。

関連項目
XFree(3X11)
Xlib - C Language X Interface