GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
OpenXPKI::Server(3) User Contributed Perl Documentation OpenXPKI::Server(3)

OpenXPKI::Server - central server class (the daemon class).

This is the main server class of OpenXPKI. If you want to start an OpenXPKI server then you must instantiate this class. Please always remember that an instantiation of this module is a startup of a trustcenter.

starts the server. It needs some parameters to configure the server but if they are correct then an exec will be performed. The parameters are the following ones:
  • DAEMON_USER
  • DAEMON_GROUP
  • CONFIG
  • SILENT (for silent startup with start-stop-daemons during System V init)

All parameters are required.

is the function which is called by Net::Server to make the work. The only parameter is the class instance. The communication is handled via STDIN and STDOUT.

The class selects the user interfaces and checks the pre-initialized variables. If all of this is fine then the user interface will be initialized and started.

does the actual work of process_request: determines transport, serialization and service from the user input and calls the init() and run() methods on the corresponding service. It also does some housekeeping such as setting permissions, setting the process name, etc.

Is executed (by Net::Server) just after the bind process and just before any chrooting, change of user, or change of group occurs. Changes the socket ownership based on the configuration.

Drops privileges to the user configured in the configuration file just before starting the main server loop.

is normal layer stack where the user interfaces can execute commands.

__redirect_stderr

Send all messages to STDERR directly to a file. The file is specified in the XML configuration.

__init_user_interfaces

Initialize the supported user interfaces (i.e. load classes).

__get_server_config

Prepares the complete server configuration to startup a socket based server with Net::Server::Fork. It returns a hashref.

Set the process name that is visible via e.g. ps.

Values used inside OpenXPKI (for easy reference):

server
Initial value of all childs, remains for the main server process
watchdog
The watchdog process
worker: init
PreForked child before its first usage
worker: connecting
Worker handling a connection (if the worker stays in this state its likely that the connection attempt failed and the worker is send back to the pool)
worker: connected
Connected to a client, waiting for a session to be started
worker: <User> (<Role>)
Connected to a client with active session as User/Role
workflow: id <id> (<state>)
Worker currently handling a workflow.
worker: wfc
Worker after finishing a request, back in the pool
2022-05-14 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.