=head1 NAME

isproxy - Invisible IRC Project (IIP) proxy

=head1 SYNOPSIS

B<isproxy> S<[ B<-dqQ> ]> S<[ B<-p> I<port> ]> S<[ B<-f> I<file-path> ]>
    S<[ B<-c> I<config-file> ]> S<[ B<-l> I<log-file> ]> S<[ B<-v> I<log-level> ]>
    S<[ B<--randomseedfile>=I<randomseed-file> ]> S<[ B<--nodefile>=I<node-file> ]>
    S<[ B<--listenfile>=I<listen-file> ]> S<[ B<--ignoreemptyrandom> ]>

B<isproxy> B<-h>

B<isproxy> B<-C>

B<isproxy> B<-K> I<keylength>

B<isproxy> B<--randomdialog>

B<isproxy> B<--kill>

B<isproxy> B<--version>

=head1 DESCRIPTION

B<isproxy> is the proxy for IIP (Invisible IRC Project). IIP is Internet Relay
Chat privacy software designed for anonymity and security. It acts as an
advanced proxy between your IRC client and servers by utilizing an encrypted
peer distributed mixnet with fake traffic and 3-layered (user, relay, and
broadcast) protection.

=head1 OPTIONS

=over 4

=item B<-d>

Don't detach.

=item B<-q, --quiet>

Don't display some messages at startup.

=item B<-Q, --quietconsole>

Don't output any logs to the console.

=item B<-p, --port>=I<port>

Bind to this local port.

=item B<-f, --filepath>=I<file-path>

File path to search for files. Default path is F<~/.iip/>

=item B<-c, --configfile>=I<config-file>

Specify an alternative I<config-file> to be parsed at startup, rather than the default one
(F<~/.iip/isproxy.ini>).

=item B<-l, --logfile>=I<log-file>

Specify an alternative I<log-file> rather than the default one (F<~/.iip/iip.log>).

=item B<-v, --loglevel>=I<log-level>

Set the verbosity of the logfile. (1-errors, 2-normal, 3-minor, 4-debug, 5-memory, 6-traffic, 7-'spam', 8-keys).

=item B<--randomseedfile>=I<randomseed-file>

Specify an alternative I<randomseed-file> rather than the default one (F<~/.iip/seed.rnd>).

=item B<--nodefile>=I<node-file>

Specify an alternative I<node-file> rather than the default one (F<~/.iip/node.ref>).

=item B<--listenfile>=I<listen-file>

Specify an alternative I<listen-file> rather than the default one (F<~/.iip/listen.ref>).

=item B<--ignoreemptyrandom>

Let B<isproxy> start up even if there isn't enough entropy.

B<THIS IS A SECURITY RISK: Don't do it unless you really need to.>

=item B<-h, -H, -?, --help>

Display a short usage description, including all available options.

=item B<-C>

Start the configurator.

=item B<-K> I<keylength>

Generate a key-pair of I<keylength> and exit. Valid keylengths are 1024, 1536, 2048, 3072, 4096, 6144 and 8192.

=item B<-R, --randomdialog>

Run the entropy gathering dialog at startup.

=item B<--kill>

Send SIGTERM to all running instances of B<isproxy>.

=item B<--version>

Show version information.

=back

=head1 FILES

=over 4

=item F<~/.iip/isproxy.ini>

The configuration file, will be generated by B<-C>.

=item F<~/.iip/iip.log>

Log file.

=item F<~/.iip/seed.rnd>

Entropy pool, will be generated on first startup.

=item F<~/.iip/node.ref>

The list of public nodes to connect to.

=item F<~/.iip/listen.ref>

Ports to bind to, will be generated by B<-C>.

=back

=head1 AUTHOR

Invisible IRC Project team E<lt>iip@invisiblenet.netE<gt>

=head1 BUGS

Please report any bugs you find on the Sourceforge project page:
L<http://www.sourceforge.net/projects/invisibleip/>

=head1 COPYRIGHT

Copyright (C) 2001-2003 Invisible IRC Project team

B<isproxy> is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.

isproxy is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License along
with B<isproxy>; see the file COPYING.  If not, write to the Free Software
Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

=head1 AVAILABILITY

The most recent released version of B<isproxy> is always available on
L<http://www.invisiblenet.net/iip/>