This is an old revision of the document!


Services

Synchronet Services1) are loadable modules or external executables designed to be loaded by the Synchronet Services Server to service a particular TCP or UDP protocol for remote client connections. Synchronet Services are similar in concept to UNIX's [x]inetd services.

Service Types

There are four types of services currently supported:

  1. Dynamic JavaScript (the most common service type)
  2. Static JavaScript (e.g. the IRC Daemon)
  3. Dynamic Native
  4. Static Native

JavaScript Services

Additional methods and properties available to Synchronet Services written in JavaScript:

Properties

Property Type Description
logged_in booleanIndication if user has successfully authenticated or not
datagram string Contents of received UDP datagram (when applicable)

Methods

Along with the common global methods, JavaScript services include support for the following methods:

Method Returns Usage Description
loginbooleanlogin(user, password [,increment_logins=false])Attempt to authenticate as specified user (name or number)
logoutbooleanlogout() Logout currently authenticated user
server.client_addvoidserver.client_add(Socket, [user], [host]) Register client based on specified socket connection, with optional username and hostname
server.client_updatevoidserver.client_update(Socket, [user], [host])Update client based on specified socket connection, with optional username and hostname
server.client_removevoidserver.client_remove(Socket) Unregister client based on specified socket connection

Configuration

Services are normally configured via the services.ini file in the ctrl directory with some global settings controlled via the [Services] section of the sbbs.ini file.

Some static services (e.g. the IRC Daemon) may alternatively be executed independently of the Services Server using JSexec.

Included Services

See Also

1)
a feature suggested by Angus McLeod of ANJO BBS
service/index.1520233372.txt · Last modified: 2018/03/04 23:02 by deuce
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0