[master 1/1] Add documentation on %anaconda kickstart command
bcl
installerbot-noreply at redhat.com
Wed Mar 25 18:34:15 UTC 2015
From: "Brian C. Lane" <bcl at redhat.com>
---
docs/kickstart.rst | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 63 insertions(+)
create mode 100644 docs/kickstart.rst
diff --git a/docs/kickstart.rst b/docs/kickstart.rst
new file mode 100644
index 0000000..59529c0
--- /dev/null
+++ b/docs/kickstart.rst
@@ -0,0 +1,63 @@
+Anaconda Kickstart Documentation
+================================
+
+Anaconda uses `kickstart <https://github.com/rhinstaller/pykickstart>`_ to automate
+installation and as a data store for the user interface. It also extends the kickstart
+commands `documented here <https://fedoraproject.org/wiki/Anaconda/Kickstart>`_
+by adding a new kickstart section named %anaconda where commands to control the behavior
+of Anaconda will be defined.
+
+.. contents:: %anaconda section commands
+
+
+pwpolicy
+========
+
+pwpolicy <name> [--minlen=LENGTH] [--minquality=QUALITY] [--strict|notstrict] [--emptyok|notempty] [--changesok|nochanges]
+ Set the policy to use for the named password entry.
+
+ name
+ Name of the password entry, currently supported values are: root, user and luks
+
+ --minlen (**8**)
+ Minimum password length. This is passed on to libpwquality.
+
+ --minquality (**50**)
+ Minimum libpwquality to consider good. When using --strict it will not allow
+ passwords with a quality lower than this.
+
+ --strict (**DEFAULT**)
+ Strict password enforcement. Passwords not meeting the --minquality level will
+ not be allowed.
+
+ --notstrict
+ Passwords not meeting the --minquality level will be allowed after Done is clicked
+ twice.
+
+ --emptyok (**DEFAULT**)
+ Allow empty password.
+
+ --notempty
+ Don't allow an empty password
+
+ --changesok
+ Allow UI to be used to change the password/user when it has already been set in
+ the kickstart.
+
+ --nochanges (**DEFAULT**)
+ Do not allow UI to be used to change the password/user if it has been set in
+ the kickstart.
+
+The defaults for these are set in the /usr/share/anaconda/interactive-defaults.ks file
+provided by Anaconda. If a product, such as Fedora Workstation, wishes to override them
+then a product.img needs to be created with a new version of the file included.
+
+When using a kickstart the defaults can be overridded by placing a %anaconda section into
+the kickstart, like this::
+
+ %anaconda
+ pwpolicy root --minlen=10 --minquality=60 --strict --notempty --nochanges
+ %end
+
+.. note:: The commit message for pwpolicy included some incorrect examples.
+
--
To view this commit on github, visit https://github.com/rhinstaller/anaconda/commit/4549bd251756811f032a057f62e35c402d4f0e2a
More information about the anaconda-patches
mailing list