'\" t
.\"     Title: sss_seed
.\"    Author: The SSSD upstream - https://github.com/SSSD/sssd/
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 04/10/2024
.\"    Manual: SSSD Manual pages
.\"    Source: SSSD
.\"  Language: English
.\"
.TH "SSS_SEED" "8" "04/10/2024" "SSSD" "SSSD Manual pages"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
sss_seed \- seed the SSSD cache with a user
.SH "SYNOPSIS"
.HP \w'\fBsss_seed\fR\ 'u
\fBsss_seed\fR [\fIoptions\fR] \-D\ \fIDOMAIN\fR \-n\ \fIUSER\fR
.SH "DESCRIPTION"
.PP
\fBsss_seed\fR
seeds the SSSD cache with a user entry and temporary password\&. If a user entry is already present in the SSSD cache then the entry is updated with the temporary password\&.
.PP
.SH "OPTIONS"
.PP
\fB\-D\fR,\fB\-\-domain\fR \fIDOMAIN\fR
.RS 4
Provide the name of the domain in which the user is a member of\&. The domain is also used to retrieve user information\&. The domain must be configured in sssd\&.conf\&. The
\fIDOMAIN\fR
option must be provided\&. Information retrieved from the domain overrides what is provided in the options\&.
.RE
.PP
\fB\-n\fR,\fB\-\-username\fR \fIUSER\fR
.RS 4
The username of the entry to be created or modified in the cache\&. The
\fIUSER\fR
option must be provided\&.
.RE
.PP
\fB\-u\fR,\fB\-\-uid\fR \fIUID\fR
.RS 4
Set the UID of the user to
\fIUID\fR\&.
.RE
.PP
\fB\-g\fR,\fB\-\-gid\fR \fIGID\fR
.RS 4
Set the GID of the user to
\fIGID\fR\&.
.RE
.PP
\fB\-c\fR,\fB\-\-gecos\fR \fICOMMENT\fR
.RS 4
Any text string describing the user\&. Often used as the field for the user\*(Aqs full name\&.
.RE
.PP
\fB\-h\fR,\fB\-\-home\fR \fIHOME_DIR\fR
.RS 4
Set the home directory of the user to
\fIHOME_DIR\fR\&.
.RE
.PP
\fB\-s\fR,\fB\-\-shell\fR \fISHELL\fR
.RS 4
Set the login shell of the user to
\fISHELL\fR\&.
.RE
.PP
\fB\-i\fR,\fB\-\-interactive\fR
.RS 4
Interactive mode for entering user information\&. This option will only prompt for information not provided in the options or retrieved from the domain\&.
.RE
.PP
\fB\-p\fR,\fB\-\-password\-file\fR \fIPASS_FILE\fR
.RS 4
Specify file to read user\*(Aqs password from\&. (if not specified password is prompted for)
.RE
.PP
\fB\-?\fR,\fB\-\-help\fR
.RS 4
Display help message and exit\&.
.RE
.SH "NOTES"
.PP
The length of the password (or the size of file specified with \-p or \-\-password\-file option) must be less than or equal to PASS_MAX bytes (64 bytes on systems with no globally\-defined PASS_MAX value)\&.
.PP
.SH "SEE ALSO"
.PP
\fBsssd\fR(8),
\fBsssd.conf\fR(5),
\fBsssd-ldap\fR(5),
\fBsssd-ldap-attributes\fR(5),
\fBsssd-krb5\fR(5),
\fBsssd-simple\fR(5),
\fBsssd-ipa\fR(5),
\fBsssd-ad\fR(5),
\fBsssd-files\fR(5),
\fBsssd-sudo\fR(5),
\fBsssd-session-recording\fR(5),
\fBsss_cache\fR(8),
\fBsss_debuglevel\fR(8),
\fBsss_obfuscate\fR(8),
\fBsss_seed\fR(8),
\fBsssd_krb5_locator_plugin\fR(8),
\fBsss_ssh_authorizedkeys\fR(8), \fBsss_ssh_knownhostsproxy\fR(8),
\fBsssd-ifp\fR(5),
\fBpam_sss\fR(8)\&.
\fBsss_rpcidmapd\fR(5)
\fBsssd-systemtap\fR(5)
.SH "AUTHORS"
.PP
\fBThe SSSD upstream \- https://github\&.com/SSSD/sssd/\fR