manページ  — LIBALIAS

この関数はプログラムでエイリアスエンジンの使用を 停止させる場合に呼び出す必要があります。 それにより、ファイアウォールに空いた隙間を塞ぐことになります。 以前との互換性や特別なセキュリティを備えるために、本関数を PacketAliasInit() が atexit(3) チェーンに付加しています。 何度呼び出しても問題はありません。

void PacketAliasSetAddress(struct in_addr addr) この関数は、ローカル領域のネットワーク外へ パケットが発信する先のソースアドレスをセットします。 PacketAliasRedirectAddr() により生成された 静的アドレス対応により上書きされない限り、 発信パケットはすべてこのアドレスに再対応付けされます。

PKT_ALIAS_RESET_ON_ADDR_CHANGE モードビット (デフォルト操作モード) が設定されている場合、 内部的なエイリアスリンクテーブルは、 エイリアスアドレスが変更されるたび、 リセットされます。 これは一連のダイアルアップ操作の中で IP アドレス状態に関わらず、 ppp(8) のようなインタフェースに便利です。

PKT_ALIAS_RESET_ON_ADDR_CHANGE モードビットが 0 にセットされていた場合、この関数は、 パケット間のエイリアスの動的変更に使用できます (オーバヘッドの少ない呼び出しです)。

パケット操作の前にこの関数を呼び出す必要があります。

unsigned int PacketAliasSetMode(unsigned int flags, unsigned int mask) この関数は、 flags 値に従ってモードビットの設定やクリアを行ないます。 mask により示されたビットだけが対象となります。 以下に示すモードビットは < alias.h> で定義されています。

PKT_ALIAS_LOG
	/var/log/alias.log ファイルへのロギングを可能にします。 ログファイルには、エイリアス・リンクの作成、削除のたびに icmp、tcp、udp へのリンク回数が記録されます。 ログファイルが tail(1) により継続的に見ることができれば、 主としてデバッグ用として有効です。
PKT_ALIAS_DENY_INCOMING
	このモードビットが設定されていると、 TCP 接続や UDP トランザクションに関連する 外部から着信するあらゆるパケットは、 呼び出しプログラムで無視 ( PacketAliasIn() であれば PKT_ALIAS_IGNORED を返す) するための印が付けられます。 パケットのエイリアスホストや ローカルネットワークから発生した接続や トランザクションに対するレスポンスに対する影響はありません。 このモードビットは片方向のファイアウォールを実装する時に有効です。
PKT_ALIAS_SAME_PORTS
	このモードビットが設定されていると、 パケットエイリアスエンジンは実際のローカルポート番号を そのままエイリアスポート番号にしようとします。 このことは (proto, alias addr, alias port, remote addr, remote port) の 5 つのパラメータのペアが一意であれば可能です。 競合が起きる場合は、このビットが設定されていても エイリアスポート番号には別の番号が選択されます。
PKT_ALIAS_USE_SOCKETS
	このビットは、エイリアスホストがパケット移送時のように ネットワーク上にトラフィックを発生させる場合必ず設定します。 パケットエイリアスホストが不明なホストアドレスや 不明のポート番号 (例えば、FTP データ接続時) からの接続を待っている時は、このモードビットは、 ポートの競合が起きないように プレースホルダとしてソケットの割り当てを定義します。 接続が確立されると、 通常は 1 分ほどでソケットは閉じられます。
PKT_ALIAS_UNREGISTERED_ONLY
	このビットが設定されていると、未登録のアドレス空間から生じた以外の ローカルネットワーク上のトラフィックが無視されます。 標準クラス A, B および C の未登録アドレスは次の通りです。 10.0.0.0 -> 10.255.255.255 (Class A subnet) 172.16.0.0 -> 172.31.255.255 (Class B subnets) 192.168.0.0 -> 192.168.255.255 (Class C subnets) このオプションは、パケットエイリアスホストが 別々のインタフェースに登録済みおよび 未登録サブネットがある場合に有効です。 登録済みサブネットは完全に外部と接続しているので、 パケットエイリアスエンジンにより パケットを送り出す必要はありません。
PKT_ALIAS_RESET_ON_ADDR_CHANGE
	このモードビットが設定されており、 PacketAliasSetAddress() が エイリアスアドレス変更のために呼ばれるケースでは、 パケットエイリアスエンジンの内部リンクテーブル内容がクリアされます。 この操作モードは、 ダイアルアップ間でのインタフェースアドレスを変更したり、 変更せずにおく ppp(8) リンクの場合に有効です。 このモードビットが設定されていない場合、 リンクテーブルはアドレスが変更されてもリセットされません。
PKT_ALIAS_PUNCH_FW
	このオプションにより、 libalias は、 FTP/IRC DCC 接続に対する ipfirewall(4) ベースのファイアウォールの `隙間' を作ることになります。 開けられた隙間は IP アドレスやポートと結び付いており、 別の接続に使用することはできません。 隙間はそれを使用している接続が消滅すれば除去されます。 libalias を使用しているプログラムを強制的に終了させる (例えば kill -9) 仕組みは、フラグの状態により、 隙間に割り当てられた全ファイアウォール領域をクリアすることで実現されています。 このことはまた PacketAliasSetFWBase() に対する 初期呼び出しでも起こります。 この呼び出しはフラグの設定の前に行なう必要があります。
PKT_ALIAS_REVERSE
	本オプションは、ライブラリが内向きパケットと外向きパケットを扱う方法を 反転させます。 これにより、外部インタフェースの代りに内部インタフェースを通過する パケットを食わせることができます。
PKT_ALIAS_PROXY_ONLY
	本オプションは、ライブラリが透過プロキシルールのみに従うよう指示します。 通常のパケットエイリアスは実行されません。 詳細は後述の PacketAliasProxyRule() を参照してください。

void PacketAliasSetFWBase(unsigned int base, unsigned int num) ファイアウォールに ( PKT_ALIAS_PUNCH_FW フラグにより) ファイアウォールの隙間に対する領域を割り当てます。 領域は全初期化ルールに従いクリアされます。

あらゆるポートアドレスは、 ネットワークアドレスのバイトオーダ表記に従っています。 これらのパラメータは htons(3) を使用して、 内部的な数値形式からネットワークバイトオーダ表記に 変換する必要があります。 アドレスもまた同様にネットワークバイトオーダ形式であり、 struct, in_addr データ型で暗黙に定義されます。

struct alias_link * PacketAliasRedirectAddr(struct in_addr local_addr, struct in_addr alias_addr) この関数は、 alias_addr への全着信トラフィックを local_addr にリダイレクトします。同様に、 local_addr からの全発信トラフィックは alias_addr にエイリアスされます。

local_addr または alias_addr が 0 の場合、 PacketAliasSetAddress() により設定された パケットエイリアシングアドレスが使用されます。 PacketAliasSetAddress() が PacketAliasRedirectAddr() の呼び出し後に アドレス変更のために呼び出されても、 0 リファレンスがこの変更を記録します。

負荷共有用にリンクが更に設定されると、 local_addr は無視され、サーバプールから動的に選択されます。 これは PacketAliasAddServer() で後述されています。

PacketAliasRedirectAddr() に対する一連の呼び出しが 同一のエイリアシングアドレスを使用している場合、 このエイリアシングアドレスへの新たな全着信トラフィックは、 最後の関数呼び出しで作られたローカルアドレスへリダイレクトされます。 いくつかの関数呼び出しで指定されたローカルマシンからの 新たな全トラフィックは、 同一のアドレスにリダイレクトされます。

PacketAliasRedirectAddr(inet_aton("192.168.0.2"),
                        inet_aton("141.221.254.101"));
PacketAliasRedirectAddr(inet_aton("192.168.0.3"),
                        inet_aton("141.221.254.101"));
PacketAliasRedirectAddr(inet_aton("192.168.0.4"),
                        inet_aton("141.221.254.101"));

192.168.0.2, 192.168.0.3 および 192.168.0.4 から、 telnet(1) や ftp(1) などでの発信接続は 141.221.254.101 からでてきたかのようにみえます。 141.221.254.101 への着信接続は 192.168.0.4 にリダイレクトされます。

PacketAliasRedirectPort() に対する呼び出しより PacketAliasRedirectAddr() で指定されたアドレス対応が必ず優先されます。

この関数は、 PacketAliasRedirectDelete() が使用するポインタを返します。 NULL が返される場合、関数呼び出しは正常に終了していません。

int PacketAliasAddServer(struct alias_link *link, struct in_addr addr, u_short port) 本関数は、 link を、IP Network Address Translation (RFC 2391, LSNAT) を使用した 負荷共有用に設定します。 LSNAT は次のように動作します。 クライアントが、サーバ仮想アドレスを使用してサーバへアクセスを試みます。 LSNAT ルータが、サーバプール中の 1 個のホストに対し、 要求を透過的にリダイレクトします。 ホスト選択には、実時間負荷共有アルゴリズムを使用します。 複数のセッションが同一のクライアントから開始されるかもしれません。 各セッションは、その時々のサーバプールホスト間の負荷バランスによって、 異なるホストに向けられる可能性があります。 数個の固有のサービスに対して負荷共有が望まれる場合、 LSNAT の設定により、望まれるサービスにのみ負荷共有を限定可能です。

現在のところ、最も単純な選択アルゴリズムのみが実装されています。 この方法は、ラウンドロビンによる選択のみであり、 ホストの負荷を考慮しないものです。

まず、 link が PacketAliasRedirectPort() または PacketAliasRedirectAddr() により作成されます。 次に PacketAliasAddServer() が複数回呼ばれ、 link のサーバプールにエントリが追加されます。

PacketAliasRedirectAddr() で作成されたリンクに対し、 port 引数は無視されいかなる値、例えば htons(~0) を持ちえます。

本関数は、成功時には 0 を返し、失敗時には -1 を返します。

void PacketAliasRedirectDelete(struct alias_link *ptr) この関数は、 PacketAliasRedirectPort() あるいは PacketAliasRedirectAddr() が設定した 特定の静的リダイレクトルールを削除します。 パラメータ ptr は、いずれかのリダイレクション関数から返されてくるポインタです。 正しくないポインタが PacketAliasRedirectDelete() に渡されると、 プログラムはクラッシュするか、予期せぬ動作結果となります。 そのためにこの関数の使用に際しては注意が必要です。

int PacketAliasProxyRule(const char *cmd) 渡された cmd 文字列は、1 個以上の、語の組からなります。 各組の最初の語はトークンであり、次の語はそのトークンに適用される値です。 トークンと引数の型は次の通りです:

type encode_ip_hdr | encode_tcp_stream | no_encode
	透過プロキシのサポートのために、 新規終点サーバに元のアドレスとポートの情報を なんらかの方法で渡す必要があります。 encode_ip_hdr が指定された場合、追加の IP オプションとして元のアドレスとポートが渡されます。 encode_tcp_stream が指定された場合、TCP ストリーム中の最初のデータ片の中に "DEST IP port" という書式で、元のアドレスとポートが渡されます。
port portnum
	終点ポートが portnum のパケットのみがプロキシの対象となります。
server host
	[:portnum] データの転送先の host と portnum を指定します。 host は、DNS ホスト名ではなく IP アドレスであることが必要です。 portnum が指定されないと、終点ポート番号は変更されません。 server の指定は、 delete コマンドが使用されない限り、必須です。
rule index
	通常、各 PacketAliasProxyRule() 呼び出しは、ルールの線型リストの先頭に次のルールを挿入します。 index が指定された場合、低いインデックスの全ルールがチェックされた後に、 新規ルールがチェックされます。 ルールを指定しない PacketAliasProxyRule() 呼び出しは、ルールにルール 0 を割り当てます。
delete index
	本トークンと引数は、他のトークンと組み合わせて使用してはなりません。 本トークンを使用すると、指定した index の既存のルールが削除されます。
proto tcp | udp
	指定すると、指定したプロトコルタイプのパケットのみがマッチします。
src IP
	[/bits] 指定すると、指定した IP に始点アドレスがマッチするパケットのみがマッチします。 bits も指定すると、 IP アドレスの最初の bits ビットのみがネットワーク指定として使用され、 そのネットワークからの全 IP アドレスがマッチします。
dst IP
	[/bits] 指定すると、指定した IP に終点アドレスがマッチするパケットのみがマッチします。 bits も指定すると、 IP アドレスの最初の bits ビットのみがネットワーク指定として使用され、 そのネットワークからの全 IP アドレスがマッチします。

本関数は、通常、ある主のインターネットアクセスを禁止されている 内部マシンに対し、外向き接続をリダイレクトするか、 またはある種の外部マシンへのアクセスを制限します。

struct alias_link * PacketAliasRedirectProto(struct in_addr local_addr, struct in_addr remote_addr, struct in_addr alias_addr, u_char proto) 本関数は、指定したリモートアドレスからエイリアスアドレスへのプロトコル番号 proto の全パケットが、指定したローカルアドレスへリダイレクトすることを指定します。

local_addr または alias_addr が 0 の場合、 で確立したパケットエイリアスアドレスが使用されることを指定します。 PacketAliasSetAddress() が PacketAliasRedirectProto() の呼び出し後に アドレス変更のために呼び出されても、 0 リファレンスがこの変更を記録します。

remote_addr が 0 の場合、 全リモートホストからのパケットをリダイレクトすることを指定します。 非 0 のリモートアドレスは、ファイアウォール用途に有用な場合があります。

2 個の PacketAliasRedirectProto() 呼び出しが、アドレス指定において重なる場合、 最新の呼び出しが優先します。

本関数は、後に PacketAliasRedirectDelete() に使用可能なポインタを返します。 NULL が返される場合、関数呼び出しは正常に終了していません。

引数 ptr は malloc(3) で割り当てられたメモリブロックを 指すことが暗黙のうちに仮定されています。 フラグメントが解決されない場合、 パケットエイリアシングエンジンは タイムアウト時間経過後、自動的にメモリを解放します [実質的には、この関数は、 メモリ解放のコールバック関数が 引数として渡されるように修正しておく必要があります]。

この関数は、正常実行の場合 PKT_ALIAS_OK を返し、エラーの場合 PKT_ALIAS_ERROR を返します。

char * PacketAliasGetFragment(char *buffer) この関数は、 PacketAliasSaveFragment() で保管された フラグメントポインタの再取り出しができます。 buffer で示す IP ヘッダフラグメントは、 PacketAliasIn() が
.Fv PKT_ALIAS_FOUND_HEADER_FRAGMENT を返したときに指定される ヘッダフラグメントです。 フラグメントのポインタが再取り出しされると、 呼び出しプログラムによりフラグメントに 動的に割り当てられていたメモリが解放されます。

フラグメントがなくなるで PacketAliasGetFragment() を続けて呼ぶことができます。 処理するフラグメントがなくなると NULL が返されてきます。

void PacketAliasFragmentIn(char *header, char *fragment) PacketAliasGetFragment() によりフラグメントの再取得を行なうとき、 PacketAliasFragmentIn() 呼び出しを実行して フラグメントのエイリアスを解除できます。 引数 header は、テンプレートとして使われているヘッダフラグメントのポインタです。 引数 fragment はエイリアス解除するパケットのポインタです。