SSSD Manual pages


Table of Contents

sssd — System Security Services Daemon

Name

sssd — System Security Services Daemon

Synopsis

sssd [ options ]

DESCRIPTION

SSSD provides a set of daemons to manage access to remote directories and authentication mechanisms. It provides an NSS and PAM interface toward the system and a pluggable backend system to connect to multiple different account sources as well as D-Bus interface. It is also the basis to provide client auditing and policy services for projects like FreeIPA. It provides a more robust database to store local users as well as extended user data.

OPTIONS

-d,--debug-level LEVEL

Bit mask that indicates which debug levels will be visible. 0x0010 is the default value as well as the lowest allowed value, 0xFFF0 is the most verbose mode. This setting overrides the settings from config file.

Currently supported debug levels:

0x0010: Fatal failures. Anything that would prevent SSSD from starting up or causes it to cease running.

0x0020: Critical failures. An error that doesn't kill the SSSD, but one that indicates that at least one major feature is not going to work properly.

0x0040: Serious failures. An error announcing that a particular request or operation has failed.

0x0080: Minor failures. These are the errors that would percolate down to cause the operation failure of 2.

0x0100: Configuration settings.

0x0200: Function data.

0x0400: Trace messages for operation functions.

0x1000: Trace messages for internal control functions.

0x2000: Contents of function-internal variables that may be interesting.

0x4000: Extremely low-level tracing information.

To log required debug levels, simply add their numbers together as shown in following examples:

Example: To log fatal failures, critical failures, serious failures and function data use 0x0270.

Example: To log fatal failures, configuration settings, function data, trace messages for internal control functions use 0x1310.

Note: This is new format of debug levels introduced in 1.7.0. Older format (numbers from 0-10) is compatible but deprecated.

--debug-timestamps=mode

1: Add a timestamp to the debug messages

0: Disable timestamp in the debug messages

Default: 1

--debug-microseconds=mode

1: Add microseconds to the timestamp in debug messages

0: Disable microseconds in timestamp

Default: 0

-f,--debug-to-files

Send the debug output to files instead of stderr. By default, the log files are stored in /var/log/sssd and there are separate log files for every SSSD service and domain.

-D,--daemon

Become a daemon after starting up.

-i,--interactive

Run in the foreground, don't become a daemon.

-c,--config

Specify a non-default config file. The default is /etc/sssd/sssd.conf. For reference on the config file syntax and options, consult the sssd.conf(5) manual page.

-?,--help

Display help message and exit.

--version

Print version number and exit.

Signals

SIGTERM/SIGINT

Informs the SSSD to gracefully terminate all of its child processes and then shut down the monitor.

SIGHUP

Tells the SSSD to stop writing to its current debug file descriptors and to close and reopen them. This is meant to facilitate log rolling with programs like logrotate.

SIGUSR1

Tells the SSSD to simulate offline operation for one minute. This is mostly useful for testing purposes.

SIGUSR2

Tells the SSSD to go online immediately. This is mostly useful for testing purposes.

SEE ALSO

sssd(8), sssd.conf(5), sssd-ldap(5), sssd-krb5(5), sssd-simple(5), sssd-ipa(5), sssd-ad(5), sssd-sudo(5), sss_cache(8), sss_debuglevel(8), sss_groupadd(8), sss_groupdel(8), sss_groupshow(8), sss_groupmod(8), sss_useradd(8), sss_userdel(8), sss_usermod(8), sss_obfuscate(8), sss_seed(8), sssd_krb5_locator_plugin(8), sss_ssh_authorizedkeys(8), sss_ssh_knowhostsproxy(8), pam_sss(8).