X-Git-Url: https://git.syn-net.org/?p=debian%2Fuanytun.git;a=blobdiff_plain;f=README;h=00a88bc2426478bcb44c33e282ec36b9f5b415b1;hp=a5bc7ee829ec507e0c472afd784ba5c838ac7626;hb=e3f8e33112e2191999c6d6f6b6a767c72db800a0;hpb=b81b2c1954fe3e3317e6fa260c5ffdc9eeee966c diff --git a/README b/README index a5bc7ee..00a88bc 100644 --- a/README +++ b/README @@ -5,6 +5,7 @@ uAnytun can be built by using either libgcrypt or the openssl-crypto library. The latter is more performant in most cases but there are some license issues when using this library. It also needs more space when installed. + Linux ----- @@ -18,19 +19,31 @@ using ssl crypto library: build-essential libssl-dev +only for manpage: + + asciidoc + OpenBSD/FreeBSD --------------- using libgcrypt: - gmake - libgcrypt - libgpg-error + devel/gmake + security/libgcrypt using ssl crypto library: - gmake + devel/gmake + +only for manpage: + + textproc/asciidoc + textproc/libxslt + textproc/docbook-xsl + sysutils/readlink + misc/getopt + Installation @@ -38,7 +51,10 @@ Installation Getting the source via subversion: ---------------------------------- -svn co https://svn.chaos-at-home.org/uanytun/trunk uanytun + +svn co https://svn.anytun.org/uanytun/trunk uanytun +cd uanytun + Building from source -------------------- @@ -55,7 +71,6 @@ using ssl crypto library: # ./configure --use-ssl-crypto # make - Notes: - try './configure --help' for further information - if using openssl pre 0.9.8 you have to disable passphrase @@ -70,8 +85,7 @@ Installing # sudo make install This will install anytun under the --prefix defined with configure. -It also creates a user with name --username with home --userhome -which can be changed by configure as well. + Uninstalling ------------ @@ -82,5 +96,30 @@ This removes everytthing except for the config files # sudo make purge -This also removes the config files and deletes the user and it's -home directory. +This also removes the config files + + + +Usage: +====== + +init.d script +------------- + +The init.d script can be used to start uanytun at boot time. It searches for +configuration files which reside at $CONFIG_DIR. For each instance of uanytun +which should be started there must be a directory containing at least a file +named config. This file must contain all command line parameter which should +be used when starting the daemon. One line for each parameter. Empty lines and +lines starting with # are ignored. Besides the config file there may be a script +named post-up.sh which will be called when the tun/tap device comes up. +This is an example of how the init.d script can be used to start uanytun: + +# /etc/init.d/uanytun start client1 p2p-a + +In this case the script will start 2 instances of uanytun using the config files +$CONFIG_DIR/client1/config and $CONFIG_DIR/p2p-a/config. +If no instance name is specified the script will use the file $CONFIG_DIR/autostart +to determine which instances to start or stop. This file must contain a list +of instance names which should be used when no names are specified at the command +line. One line for each name. Empty lines and lines starting with # are ignored.