Introduction
A services.conf file consists of a number of lines read by services at startup.
Each `line' consists of a word, followed by a colon, and then a value. At this time there are no complex (multi-value) config items.
Lines starting with a `#' symbol are comments and services does not use them.
Certain parameters must be configured in any services.conf file.
Configuration Lines
[MANDATORY]
- Host configuration (H line):
- A H line contains the name of the services server. Example:
- Port configuration (P line):
- A P line tells services what port on the IRC server to connect to as a server. Example:
- Password configuration (W line):
- A W line tells services what password to use when connecting connect to an IRC server. Example:
- IRC Server configuration (C line):
- A C line tells services the address of the IRC server to connect to (note, the IRC server must have a C-line and a N-line for services using a password specified in the services W line for services to connect to IRC.) Example:
- Services client configuration (XX lines):
- An ON-line tells services what OperServ's nickname should be
- An OU-line tells services what OperServ's username should be
- An OH-line tells services what OperServ's hostname should be
- An OR-line tells services what OperServ's realname should be
- An OM-line tells services what OperServ's usermode should be
- Nx, Cx, Mx, and Ix are the same respectively for NickServ, ChanServ, MemoServ, and InfoServ.
C:localhost
### OperServ ###
ON:OperServ
OU:warlock
OH:sorcery.net
OR:Operator Services
OM:+oi
### NickServ ###
NN:NickServ
NU:sorceress
NH:sorcery.net
NR:Nickname Services
NM:
### ChanServ ###
CN:ChanServ
CU:wizard
CH:sorcery.net
CR:Channel Services
CM:
### MemoServ ###
MN:MemoServ
MU:witch
MH:sorcery.net
MR:Memo Services
MM:
### InfoServ ###
IN:InfoServ
IU:sorcerer
IH:sorcery.net
IR:Information Services
IM:
[RECOMMENDED]
- Limits (CL, NL, OL, BL, LL lines)
- These configuration lines are used to set limits on user data within services.
- CL Maximum number of registered channels (Default: 10)
- NL Maximum number registered nicknames (Default: 5) [not enforced]
- OL Maximum number channel operator access entries per channel (Default: 25)
- BL Maximum number akick list entries per channel (Default: 30)
- LL Maximum number nickserv access entries per nickname (Default: 3)
OL:251
BL:100
LL:10
CL:10
NL:5
[OPTIONAL]
- Services IPC port configuration (IPCPORT line):
- A IPCPORT line tells services to enable IPC (inter-process communication) and listen on a particular port for connections. Example:
- Note that it is necessary to set up IPC logins and be using proper software for IPCPORT to be useful.
- If an IPCPORT line is not specified, then IPC is disabled.
Services root configuration (SRA line):
- A SRA line tells services that a particular registered nickname should be given Services Root access. Example:
- Warning: Services root access allows a user to make any change available to be made online. It is advisable to limit this permission flag to trusted, competent users and developers who are familiar with the internals of this software.
- SRA lines should not be added for a nickname until that nickname is registered.
- Services.conf can be reloaded to make a new SRA (if there is not one yet) by kill ing services with the `HUP' signal. Example:
ps xwu |grep services
kill -HUP 1234
- Services.conf can also be reloaded by a SRA with the command: /OperServ REHASH.
Services Operator configuration (SERVOP line):
- A SERVOP line tells services that a particular registered nickname should be given ServOP access. Example:
- ServOp access grants many of the SRA features such as the ability to delete nicknames, channels, perm akills, ignores, autohurts; however, it does not grant the ability to change operator access flags, directly modify things, shutdown services, or access internal debugging commands.
- ServOps can be added or removed when services is online using the /OperServ SETOP command.
Generated at Sat Oct 25 20:56:13 2003 for Services using
Doxygen.
Services Copyr. 1996-2001 Chip Norkus, Max Byrd, Greg Poma,
Michael Graff, James Hess, Dafydd James. All rights reserved
See LICENSE for licensing information.