[4mIROFFER[24m(1)                       User Manuals                       [4mIROFFER[24m(1)

[1mNAME[0m
       iroffer -- DCC file server bot

[1mSYNOPSIS[0m
       [1miroffer -v[0m

       [1miroffer -c [configfile][0m

       [1miroffer [-b] [-d] [-k] [-n] [-s] [-u user] [-t dir] [-i file] config-[0m
       [1mfile [configfile ...][0m

[1mDESCRIPTION[0m
       [1miroffer  [22mis a file server which uses the DCC feature of IRC to send re-
       quested files to other users. The name of a configuration file must  be
       given on the command line for normal operation.

[1mOPTIONS[0m
       [1m-v     [22mDisplay version information and exit.

       [1m-c     [22mGenerate  an  encrypted  password  and exit.  If a configfile is
              given, the encrypted password will not be printed, but  directly
              added to the end of the configfile.

       [1m-b     [22mRun in the background.

       [1m-d     [22mIncrease debug level.

       [1m-k     [22mAttempt to adjust ulimit to allow core files.

       [1m-n     [22mNo colors in foreground mode.

       [1m-s     [22mNo screen manipulation in foreground mode.

       [1m-u user[0m
              Run as user (you have to start as root).

       [1m-t dir [22mChroot to dir (you have to start as root).

       [1m-w dir [22mChdir to dir as working directory.

       [1m-i file[0m
              Import and old style mybot.xdcc file.

[1mIMPLEMENTATION NOTES[0m
       [1mmultiple IRC networks[0m
              Supports connecting to multiple IRC networks at the same time.

       [1mIPv6   [22mSupports connecting and transfers via IPv6

       [1mDCC    [22mSupports transfers of files greater 4 GB.

       [1mpassive DCC[0m
              Supports passive DCC transfers and uploads.

       [1mHTTP server[0m
              Supports internal HTTP server for status and pack list.

       [1mTelnet server[0m
              Supports internal Telnet server for background administration.

       [1mFISH encrpytion[0m
              Support for FISH encryption for mesasages and channel.

       [1mSSL encrpytion[0m
              Optional support to connect via SSL to IRC-servers if OpenSSL or
              GnuTLS is available.

       [1mCertFP with SSL[0m
              CertFP authentication with SSL.

       [1mGeoIP and GeoIPv6[0m
              Optional support to limit transfers to countrys with libGeoIP.

       [1mCurl   [22mOptional  support to fetch files via FTP/HTTP if libcurl is com-
              piled in.

       [1mUPnP   [22mOptional Universal Plug and Play  support  to  connect  via  NAT
              Routers,  this  requires  lib miniupnpc present.  Used to obtain
              public IP-Address and Set/Remove port  forwarding  for  incoming
              connections.

       [1mRuby   [22mOptional support for scripting plugins in Ruby.  Support for CGI
              scripts with the internal HTTP server.

       [1mXML    [22mSupport for XML Packlist allows integration with other websites.

       [1mBatch  [22mAllows batched transfers without delaying new users.

[1mRETURN VALUES[0m
       The iroffer program exits 0 on successful termination, and >0 if an er-
       ror occurs.

[1mSIGNALS[0m
       [1mSIGUSR1[0m
              Jumps to another server, same as admin command "JUMP".

              kill -USR1 `mybot.pid`

       [1mSIGUSR2[0m
              Re-reads config file, same as admin command "REHASH"

              kill -USR2 `mybot.pid`

       [1mSIGTERM[0m
              Shuts down iroffer, same as admin command "SHUTDOWN NOW"

              kill `mybot.pid`

[1mFILES[0m
       [1mmybot.pid[0m
              the pid of the currently running iroffer

       [1mmybot.state[0m
              the main database for the iroffer

       [1mmybot.txt[0m
              generated list of packs in plain text

       [1mmybot.xml[0m
              generated list of packs in XML

       [1mmybot.log[0m
              logfile wit all notes error and while running

[1mSEE ALSO[0m
       [1m/usr/share/doc/iroffer[0m
              Please look for more detailed information in this directory.

       [1mhttps://iroffer.net/[0m
              Downloads and Documentation.

       [1mhttps://project.iroffer.de/projects/iroffer[0m
              Project page with Tracker and RSS feed.

[1mHISTORY[0m
       The original iroffer version was written by by David Johnson.

       iroffer-dinoex is developed by Dirk Meyer.

All Posix OS                      Januar 2011                       [4mIROFFER[24m(1)
