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

AUTHORS

Autrijus Tang <autrijus@autrijus.org>

COPYRIGHT

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