The shibd command runs the Shibboleth SP daemon process that handles state management and most of the SAML and security processing of the software. On Windows, it is designed to run either from the command line or as a "service". On Unix platforms prior to version 2.2, it will not put itself into the background, but can be backgrounded by the controlling shell in the usual manner. As of version 2.2, the process backgrounds itself by default, but can be kept in the foreground with a command line option.
The following command line options are available based on the platform.
Windows
Option |
Explanation |
|---|---|
-check |
Runs in console mode and loads the configuration, logging any serious issues to the console, then exits. |
-console |
Runs the program as a console application in the foreground rather than as a service. |
-prefix path |
Alternative to SHIBSP_PREFIX environment variable. |
-config pathname |
Alternative to SHIBSP_CONFIG environment variable. |
-catalogs pathname1;pathname2 |
Alternative to SHIBSP_SCHEMAS environment variable. |
-install name |
Installs the program as a service using a provided name to distinguish it from other copies. |
-remove name |
Removes the named service definition. |
Unix
Option |
Explanation |
|---|---|
-t |
Loads the configuration, logging any serious issues to the console, then exits. |
-d path |
Alternative to SHIBSP_PREFIX environment variable. |
-c pathname |
Alternative to SHIBSP_CONFIG environment variable. |
-x pathname1:pathname2 |
Alternative to SHIBSP_SCHEMAS environment variable. |
-f |
Forces removal of Unix domain socket file if the file is present when starting up. |
-p pathname |
Path to pid file to create. |
-v |
Prints software version. |
-h |
Help message. |
Version 2.2 and Above
Option |
Explanation |
|---|---|
-w |
Seconds to wait for the background process to fully initialize before returning success or failure to the shell. |
-F |
Keep the process in the foreground. |