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