|
 |
f707ba |
From fee9bde11b42ab39af6397a0c0ce4775443b28ea Mon Sep 17 00:00:00 2001
|
|
|
f707ba |
From: Stef Walter <stefw@redhat.com>
|
|
|
f707ba |
Date: Mon, 6 Feb 2017 12:25:52 +0100
|
|
|
f707ba |
Subject: [PATCH] doc: Add short arguments like -U arguments to realm manual
|
|
|
f707ba |
page
|
|
|
f707ba |
|
|
|
f707ba |
And clean up the documentation for the various arguments.
|
|
|
f707ba |
---
|
|
|
f707ba |
doc/manual/realm.xml | 70 +++++++++++++++++++++++---------------------
|
|
|
f707ba |
1 file changed, 37 insertions(+), 33 deletions(-)
|
|
|
f707ba |
|
|
|
f707ba |
diff --git a/doc/manual/realm.xml b/doc/manual/realm.xml
|
|
|
f707ba |
index 6724d80..9d9136a 100644
|
|
|
f707ba |
--- a/doc/manual/realm.xml
|
|
|
f707ba |
+++ b/doc/manual/realm.xml
|
|
|
f707ba |
@@ -60,7 +60,7 @@
|
|
|
f707ba |
|
|
|
f707ba |
<variablelist>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
- <term><option>--install=/path</option></term>
|
|
|
f707ba |
+ <term><option>-i</option>, <option>--install=/path</option></term>
|
|
|
f707ba |
<listitem><para>Run in install mode. This makes realmd
|
|
|
f707ba |
chroot into the specified directory and place files in
|
|
|
f707ba |
appropriate locations for use during an installer. No
|
|
|
f707ba |
@@ -73,7 +73,7 @@
|
|
|
f707ba |
for input.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
- <term><option>--verbose, -v</option></term>
|
|
|
f707ba |
+ <term><option>-v</option>, <option>--verbose</option></term>
|
|
|
f707ba |
<listitem><para>Display verbose diagnostics while doing
|
|
|
f707ba |
running commands.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
@@ -105,7 +105,7 @@ $ realm discover domain.example.com
|
|
|
f707ba |
|
|
|
f707ba |
<variablelist>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
- <term><option>--all</option></term>
|
|
|
f707ba |
+ <term><option>-a</option>, <option>--all</option></term>
|
|
|
f707ba |
<listitem><para>Show all discovered realms (in various
|
|
|
f707ba |
configurations).</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
@@ -116,6 +116,10 @@ $ realm discover domain.example.com
|
|
|
f707ba |
<replaceable>sssd</replaceable> or
|
|
|
f707ba |
<replaceable>winbind</replaceable>.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
+ <varlistentry>
|
|
|
f707ba |
+ <term><option>-n</option>, <option>--name</option></term>
|
|
|
f707ba |
+ <listitem><para>Only show the names of the discovered realms.</para></listitem>
|
|
|
f707ba |
+ </varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
<term><option>--server-software=xxx</option></term>
|
|
|
f707ba |
<listitem><para>Only discover realms which run the
|
|
|
f707ba |
@@ -187,10 +191,13 @@ $ realm join --user=admin --computer-ou=OU=Special domain.example.com
|
|
|
f707ba |
in the domain already.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
- <term><option>--user=xxx</option></term>
|
|
|
f707ba |
- <listitem><para>The user name to be used to authenticate
|
|
|
f707ba |
- with when joining the machine to the realm. You will
|
|
|
f707ba |
- be prompted for a password.</para></listitem>
|
|
|
f707ba |
+ <term><option>--client-software=xxx</option></term>
|
|
|
f707ba |
+ <listitem><para>Only join realms for which we can
|
|
|
f707ba |
+ use the given client software. Possible values include
|
|
|
f707ba |
+ <replaceable>sssd</replaceable> or
|
|
|
f707ba |
+ <replaceable>winbind</replaceable>. Not all values are
|
|
|
f707ba |
+ supported for all realms. By default the client software
|
|
|
f707ba |
+ is automatically selected.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
<term><option>--computer-ou=OU=xxx</option></term>
|
|
|
f707ba |
@@ -201,6 +208,14 @@ $ realm join --user=admin --computer-ou=OU=Special domain.example.com
|
|
|
f707ba |
DSE portion of distinguished name. This is an Active
|
|
|
f707ba |
Directory specific option.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
+ <varlistentry>
|
|
|
f707ba |
+ <term><option>--membership-software=xxx</option></term>
|
|
|
f707ba |
+ <listitem><para>The software to use when joining to the
|
|
|
f707ba |
+ realm. Possible values include <replaceable>samba</replaceable> or
|
|
|
f707ba |
+ <replaceable>adcli</replaceable>. Not all values are
|
|
|
f707ba |
+ supported for all realms. By default the membership software
|
|
|
f707ba |
+ is automatically selected.</para></listitem>
|
|
|
f707ba |
+ </varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
<term><option>--no-password</option></term>
|
|
|
f707ba |
<listitem><para>Perform the join automatically without
|
|
|
f707ba |
@@ -213,13 +228,16 @@ $ realm join --user=admin --computer-ou=OU=Special domain.example.com
|
|
|
f707ba |
all types of realms.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
- <term><option>--client-software=xxx</option></term>
|
|
|
f707ba |
- <listitem><para>Only join realms for which we can
|
|
|
f707ba |
- use the given client software. Possible values include
|
|
|
f707ba |
- <replaceable>sssd</replaceable> or
|
|
|
f707ba |
- <replaceable>winbind</replaceable>. Not all values are
|
|
|
f707ba |
- supported for all realms. By default the client software
|
|
|
f707ba |
- is automatically selected.</para></listitem>
|
|
|
f707ba |
+ <term><option>--os-name=xxx</option></term>
|
|
|
f707ba |
+ <listitem><para>The name of the operation system of the
|
|
|
f707ba |
+ client. When joining an AD domain the value is store in
|
|
|
f707ba |
+ the matching AD attribute.</para></listitem>
|
|
|
f707ba |
+ </varlistentry>
|
|
|
f707ba |
+ <varlistentry>
|
|
|
f707ba |
+ <term><option>--os-version=xxx</option></term>
|
|
|
f707ba |
+ <listitem><para>The version of the operation system of the
|
|
|
f707ba |
+ client. When joining an AD domain the value is store in
|
|
|
f707ba |
+ the matching AD attribute.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
<term><option>--server-software=xxx</option></term>
|
|
|
f707ba |
@@ -229,12 +247,10 @@ $ realm join --user=admin --computer-ou=OU=Special domain.example.com
|
|
|
f707ba |
<replaceable>ipa</replaceable>.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
- <term><option>--membership-software=xxx</option></term>
|
|
|
f707ba |
- <listitem><para>The software to use when joining to the
|
|
|
f707ba |
- realm. Possible values include <replaceable>samba</replaceable> or
|
|
|
f707ba |
- <replaceable>adcli</replaceable>. Not all values are
|
|
|
f707ba |
- supported for all realms. By default the membership software
|
|
|
f707ba |
- is automatically selected.</para></listitem>
|
|
|
f707ba |
+ <term><option>-U</option>, <option>--user=xxx</option></term>
|
|
|
f707ba |
+ <listitem><para>The user name to be used to authenticate
|
|
|
f707ba |
+ with when joining the machine to the realm. You will
|
|
|
f707ba |
+ be prompted for a password.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
<term><option>--user-principal=<parameter>host/name@REALM</parameter></option></term>
|
|
|
f707ba |
@@ -243,18 +259,6 @@ $ realm join --user=admin --computer-ou=OU=Special domain.example.com
|
|
|
f707ba |
the value for this option, then a principal will be set
|
|
|
f707ba |
in the form of <literal>host/shortname@REALM</literal></para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
- <varlistentry>
|
|
|
f707ba |
- <term><option>--os-name=xxx</option></term>
|
|
|
f707ba |
- <listitem><para>The name of the operation system of the
|
|
|
f707ba |
- client. When joining an AD domain the value is store in
|
|
|
f707ba |
- the matching AD attribute.</para></listitem>
|
|
|
f707ba |
- </varlistentry>
|
|
|
f707ba |
- <varlistentry>
|
|
|
f707ba |
- <term><option>--os-version=xxx</option></term>
|
|
|
f707ba |
- <listitem><para>The version of the operation system of the
|
|
|
f707ba |
- client. When joining an AD domain the value is store in
|
|
|
f707ba |
- the matching AD attribute.</para></listitem>
|
|
|
f707ba |
- </varlistentry>
|
|
|
f707ba |
</variablelist>
|
|
|
f707ba |
|
|
|
f707ba |
</refsect1>
|
|
|
f707ba |
@@ -300,7 +304,7 @@ $ realm leave domain.example.com
|
|
|
f707ba |
for a pasword.</para></listitem>
|
|
|
f707ba |
</varlistentry>
|
|
|
f707ba |
<varlistentry>
|
|
|
f707ba |
- <term><option>--user</option></term>
|
|
|
f707ba |
+ <term><option>-U</option>, <option>--user</option></term>
|
|
|
f707ba |
<listitem><para>The user name to be used to authenticate
|
|
|
f707ba |
with when leaving the realm. You will be prompted for a
|
|
|
f707ba |
password. Implies <option>--remove</option>.</para></listitem>
|
|
|
f707ba |
--
|
|
|
f707ba |
2.21.0
|
|
|
f707ba |
|