DragonFly On-Line Manual Pages

Search: Section:  

BBSCOMD(1)            User Contributed Perl Documentation           BBSCOMD(1)


NAME

       bbscomd - OurNet BBS Remote Access Daemon


SYNOPSIS

       bbscomd [ -acdfgGhsx ] [ -b addr ] [ -p     port ] [ -u key ]
           [ -l logfile ] [ -t timeout ]  backend     [ argument... ]


DESCRIPTION

       The bbscomd starts a OurNet::BBS::Server daemon listening on the
       specified port (default 7979). Remote users could then start using the
       OurNet backend or OurNet::BBS::Client to connect like this:

           use OurNet::BBS;
           my $Remote_BBS = OurNet::BBS->new(OurNet => 'remote.org');

       If the "-f" flag is specified, bbscomd will fork a new process to run
       as daemon. The "-d" flag turns on debugging.

       The "-u" specifies the pgp keyid or userid used in authorization.  If
       "-a" is supplied, the server will serve in the authenticated mode with
       additional permission controls. Similarly, "-c" disallows insecure
       cipher modes.

       The "-g" flag allows server to assume "guest" as the user ID on a
       failed Authentication (fallback to AUTH_NONE), with corresponding
       permissions.

       Similarly, the "-G" flag allows the client to authenticate as ANY user
       they wanted to; because of the security risk, this flag automatically
       specifies "-b localhost" for you. Note that this does not assume the
       behaviour of "-g"; you'll have to specify "-gG" explicitly to turn on
       both settings.

       The "-s" flag permits single-connection only. This is primary used for
       single-user situations.

       The "-x" flag assumes default settings on Win32. It's not meant to be
       used on other platforms.

       If you don't want to bind all available IPs, specify one using the "-b"
       flag.

       The "-t" flag sets the "connection-timeout" option to the Server
       object, which causes a child connection to terminate after an
       inactivity for timeout seconds.

       If you want to keep a Net::Daemon styled log file, specify the file
       name to "-l".

       Please refer to OurNet::BBS modules for more information on usage.


EXAMPLES

       Starting a typical MELIX daemon, require authentication, but allowing
       unprivileged guest access:

           % bbscomd -acfg -u melix MELIX /home/melix 2997 350

       Starting a localhost-only bridge at port 8080 to another OurNet node,
       with debugging output:

           % bbscomd -d -b 127.0.0.1 -p 8080 OurNet localhost


SEE ALSO

       OurNet::BBS, RPC::PlServer, Net::Daemon


AUTHORS

       Autrijus Tang <autrijus@autrijus.org>


COPYRIGHT

       Copyright 2001-2002 by Autrijus Tang <autrijus@autrijus.org>.

       This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.20.2                      2003-10-20                        BBSCOMD(1)

Search: Section: