From 1adde65db245ec1fca752cfee4c198badf40fb5f Mon Sep 17 00:00:00 2001 From: Jakub Sławiński Date: Tue, 15 Mar 2005 01:22:55 +0100 Subject: v0.6 - Fixed: default password incompatibilities from config file - Added: "client's id" option - Lightly Modified: verbose mode - Added: temporary listen ports - Fixed: bug in printing "client's id" - Added: 'dateformat' option to set format of the date in the logs - Modified: command line option and config file behaviour - Added: logging to a socket - Fixed: parsing config file - Fixed: major bug in packet buffering - Added: several clients-users in one realm - Modified: default hostname used by afserver - Modified: server listening behaviour (for clients) - Fixed: bug in checking options values - Modified: verbose mode - Modified: client initial connection to server - Added: connection time / uptime statistics - Added: first version of remote administration (statistics only) - Fixed: major bug in remove_client routine - Added: 'raclients' option - Added: use of automake/autoconf - Added: creating ~/.apf directory - Modified: the way of creating/managing keys/certificates - Added: 'dnslookups' option - Modified: usage functions - Fixed: no handling of missing 'listen' option after 'newrealm' in config file - Added: 'quit' command in remote administration mode - Modified: logging error messages during initialization - Modified: 'newrealm' changed to 'realm' in config file - Added: realm names - Modified: connection time / uptime - Added: client names / unique numbers - Added: user unique numbers - Fixed: segmentation fault after 'quit' command --- doc/afserver.1 | 175 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 175 insertions(+) create mode 100644 doc/afserver.1 (limited to 'doc/afserver.1') diff --git a/doc/afserver.1 b/doc/afserver.1 new file mode 100644 index 0000000..0a39c2c --- /dev/null +++ b/doc/afserver.1 @@ -0,0 +1,175 @@ +.TH afserver 1 "apf 0.6" Jeremian +.SH NAME +afserver \- active port forwarder server +.SH SYNOPSIS +.B afserver [ +.I options +.B ] +.SH DESCRIPTION +.B Afserver +is a port forwarding program designed to be efficient and easy to use. It listens for incoming +.B afclient +connections at listenport (default listenport is 50126). After successful client authorization, +.B afserver +listens for incoming user connections. When a new user connection is opened, all the data is redirected to previously connected +.B afclient, +which redirects it to the specified destination host:port. +.SH EXAMPLES +.B afserver + program starts with default options (become a daemon) + +.B afserver -v + verbose mode is enabled (program won't enter daemon mode) + +.B afserver -n localhost -l 5435 -m 6375 + program will listen on localhost:5435 for users and on localhost:6375 for clients +.SH OPTIONS +.I "Basic options" + +.B -n, --hostname NAME + used when creating listening sockets (default: '') + +.B -l, --listenport PORT + listening port number - users connect to it (default: 50127) + +.B -m, --manageport PORT + manage port number - +.I afclient +connects to it (default: 50126) + +.B -h, --help + prints help screen + +.I Authorization + +.B --pass PASSWORD + password used for client identification (default: no password) + +.I Configuration + +.B -c, --cerfile FILE + the name of the file with certificate (default: cacert.pem) + +.B -k, --keyfile FILE + the name of the file with RSA key (default: server.rsa) + +.B -f, --cfgfile FILE + the name of the file with the configuration for the +.I afserver + +.B -D, --dateformat FORMAT + format of the date printed in logs (see 'man strftime' for details) (default: %d.%m.%Y %H:%M:%S) + +.B -t, --timeout N + the timeout value for the client's connection (default: 5) + +.B -u, --users N + the amount of users allowed to use this server (default: 5) + +.B -C, --clients N + the number of allowed clients to use this server (default: 1) + +.B -r, --realm + set the realm name (default: none) + +.B -R, --raclients N + the number of allowed clients in remote administration mode to use this server (default: 1) + +.B -U, --usrpcli N + the number of allowed users per client (default: $users) + +.B -M, --climode N + strategy used to connect users with clients (default: 1) + Available strategies: + 1. fill first client before go to next + +.B -p, --proto TYPE + type of server (tcp|udp) - what protocol it will be operating for (default: tcp) + +.B -b, --baseport + listenports are temporary and differ for each client + +.B --nossl + ssl is not used to transfer data (but it's still used to establish a connection) (default: ssl is used) + +.B --nozlib + zlib is not used to compress data (default: zlib is used) + +.B --dnslookups + try to obtain dns names of the computers rather than their numeric IP + +.I Logging + +.B -O, --heavylog + logging everything to a logfile + +.B -o, --lightlog + logging some data to a logfile + +.B -S, --heavysocklog + logging everything to a localport + +.B -s, --lightsocklog + logging some data to a localport + +.B -v, --verbose + to be verbose - program won't enter the daemon mode (use several times for greater effect) + +.I "IP family" + +.B -4, --ipv4 + use ipv4 only + +.B -6, --ipv6 + use ipv6 only + +.SH "REMOTE ADMINISTRATION" + +Currently available commands are: + +.B help + display help + +.B lcmd + lists available commands + +.B info + prints info about server + +.B rshow + display realms + +.B cshow X + display clients in X realm + +.B ushow X + display users in X realm + +.B quit + quit connection + +.SH "SEE ALSO" + +.BR afclient (1), +.BR afserver.conf (5) + +.SH BUGS + +.B Afserver +is still under development. There are no known open bugs at the moment. + +.SH "REPORTING BUGS" + +Please report bugs to + +.SH AUTHOR + +Jeremian + +.SH CONTRIBUTIONS + +Alex Dyatlov , Simon , Ilia Perevezentsev and Marco Solari + +.SH LICENSE + +Active Port Forwarder is distributed under the terms of the GNU General Public License v2.0 and is copyright (C) 2003,2004,2005 jeremian . See the file COPYING for details. -- cgit v1.1