IROFFER(1)                       User Manuals                       IROFFER(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
       requested 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 availible.

       [1mCertFP with SSL[0m
              CertFP Authentification 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 forwardings for incomming
              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
       error 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
              Projectpage 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                       IROFFER(1)
