NAME
afclient.conf - Configuration File for afclient
INTRODUCTION
Afclient supports several mechanisms to supply configuration and run-
time parameters: command line options, afclient.conf and hard-coded
defaults. When the same information is supplied in more than one way,
the highest precedence mechanism is used. When configuration file is
used (option: -f FILE) command line options like --reverseudp,
--udpmode, --remoteadmin, --load, --Load and --pass are ignored.
Options from configuration file are taken before values from command
line (with the exception of --keyfile, --storefile, --dateformat,
--ignorepkeys and the options connected with http proxy and auto-
reconnect support). When something is not declared, hard-coded values
are used.
DESCRIPTION
Afclient uses configuration file, which name is supplied by the -f FILE
option. The afclient.conf file is the set of command-line like options,
which can be written in any order.
OPTIONS
servername NAME
name of the host, where afserver is running
manageport PORT
manage port number - server must be listening on it (default: 50126)
hostname NAME
the name of this host/remote host - the final destination of the
packets (default: the name returned by hostname function)
portnum PORT
the port we are forwarding connection to
localname NAME
local machine name for connection with afserver (used to bind socket
to different interfaces)
localport NAME
local port name for connection with afserver (used to bind socket to
different addressees)
localdesname NAME
local machine name for connections with destination application (used
to bind socket to different interfaces)
id STRING
sends the id string to afserver
pass PASSWORD
set the password used for client identification (default: no
password)
ignorepkeys
ignore invalid server’s public keys
keyfile FILE
the name of the file with RSA key (default: client.rsa)
cerfile FILE
the name of the file with certificate (default: no certificate used)
storefile FILE
the name of the file with stored public keys (default: known_hosts)
dateformat FORMAT
format of the date printed in logs (see ’man strftime’ for details)
(default: %d.%m.%Y %H:%M:%S). Format string is trimmed. In order to
include white characters into format string, use dots to mark beginning
and end of the text. If the dot is first or last character, it’s
removed. Only one character from the beginning and one from the end can
be removed.
keep-alive N
send keepalive packets every N seconds (default: not send keepalive
packets)
ar-start
enable auto-reconnection when afserver is not reachable on start
(default: disabled)
ar-quit
enable auto-reconnection after normal afserver quit (default:
disabled)
noar
disable auto-reconnection after premature afserver quit (default:
enabled)
ar-tries N
try N times to reconnect (default: unlimited)
ar-delay N
wait N seconds between reconnect tries (default: 5)
udpmode
udp mode - client will use udp protocol to communicate with the
hostname:portnum
reverseudp
reverse udp forwarding. Udp packets will be forwarded from
hostname:portnum to the server name:manageport
remoteadmin
remote administration mode. (using ’-p PORT’ will force afclient to
use port rather than stdin-stdout)
log LOGCMD
log choosen information to file/socket
ipv4
use ipv4 only
ipv6
use ipv6 only
load FILE
load a module for user’s packets filtering
Load FILE
load a module for service’s packets filtering
use-https
use https proxy instead of http proxy
proxyname NAME
the name of the machine with proxy server
proxyport PORT
the port used by proxy server (default: 8080)
pa-cred U:P
the user (U) and password (P) used in proxy authorization
pa-t-basic
the Basic type of proxy authorization (default)
SEE ALSO
afserver.conf(5), afclient(1), afserver(1)
AUTHOR
Jeremian <jeremian [at] poczta.fm>
CONTRIBUTIONS
Alex Dyatlov <alex [at] gray-world.net>, Simon <scastro [at]
entreelibre.com>, Ilia Perevezentsev <iliaper [at] mail.ru>, Marco
Solari <marco.solari [at] koinesistemi.it>, and Joshua Judson Rosen
<rozzin [at] geekspace.com>
LICENSE
Active Port Forwarder is distributed under the terms of the GNU General
Public License v2.0 and is copyright (C) 2003-2007 jeremian <jeremian
[at] poczta.fm>. See the file COPYING for details.