man8/dbman

Table of Contents

Name

dbman - AccelNET database server

Synopsis

dbman <argument list>

Description

This is the AccelNET database server.

When it started it forks a copy of itself and tells the child that it’s name is pgman. It’s the same program except that it creates it’s own listener socket and makes to tcp connection to the parent so as to insure that should the parent process die it will croak also.

The parent copy of the program watches for the death of the child via waitpid() and will croak if the child dies or is not created successfully.

Arguments

Argument processing is done using Unix long argument syntax.
--access_tbl <fn>

The name of the access file. If not provided or the environment var is not set access control is not enabled.

--auth_tbl <fn>

The name of the authorization file. If not provided or the environment var is not set the task exits.

--size_tbl <fn>

The name of the database table size configuration file. If not provided or the environment var is not set the default size database will be configured. See tblmngr/MasterTbl.c for default size information.

--reg_tbl_size <n>

The maximum number of file descriptors which can be serviced. Usually the default value is ok.

--no_daemon

If this argument is present stdout and stdin are left open, the program may be killed by SIGINT, and the menu is active.

--log_reg

If this argument is present then each time a registration operation is performed diagnostics are printed to stderr.

--log_disconnect=<n>

If this argument is present then each time a socket is disconnected diagnostics are printed to stderr.

default: 0

valid values are:
0 - no logging

1 - log abnormal disconnects

2 - log all disconnects

If <n> is missing the value is set to: 1

--log_sendrec=<n>

default: 0

This argument sets the value of SendRec()s verbosity argument See the SendRec(3tcp) man page for more information.

If <n> is missing the value is set to: 1

--log_recvrec=<n>

default: 0

This argument sets the value of RecvRec()s verbosity argument See the RecvRec(3tcp) man page for more information.

If <n> is missing the value is set to: 1

--help

Print the help message to stderr and exit.

Environment Variables

If command line arguments are present, they override the environment vars.
ACCESS_FILE

the path name of the access file

AUTH_FILE

the path name of the user authorization file

AUTH_FILE_DEF

the path name of the default authorization file

CONF

the contract name.

This is used to set the database name.

DB_SIZE_FILE

the path name of the database sizing configuration file

DB_LOG_FILE

the path name of dbman’s logging file.

PG_LOG_FILE

the path name of dbman’s logging file.

MASTER_TBL_ADDR
If present this value is used for the shared memory attachment address. If not, the value of segaddrDB in memdef.h is used.

MASTER_TBL_KEY
If present this value is used for the and the shared memory key. If not, the value of memkeyDB in memdef.h is used.

Access Control

The access file is used to limit which IP addresses may be used to connect to dbman. The file may contain IP addresses or host names.

Each host which is allowed to connect must be specified separately in the file. There is no provision for wildcarding, i.e. specifying entire networks.

If access control is enabled an entry for localhost is automatically created and does not need to be placed in the file.

Comments may be added to the file by placing a # on the line preceeding the beginning of the comment. Comments end at the end of the line.

Notes

If the database partition already exists the sizing information in the size configuration file is ignored but must match the loaded database else pgman will fail.

Manual Page Revision

$Id: dbman.8,v 1.7 2009/09/24 13:16:42 kitchen Exp $


Table of Contents