Attachment 295833 Details for Bug 433878 – move ipa-getkeytab man page to proper subdir

[patch] move ipa-getkeytab man page to proper subdir

freeipa-675-man.patch (text/plain), 8.03 KB, created by Rob Crittenden on 2008-02-25 19:56:43 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Rob Crittenden

Created: 2008-02-25 19:56:43 UTC

Size: 8.03 KB

patch

obsolete

># HG changeset patch
># User Rob Crittenden <rcritten@redhat.com>
># Date 1203969369 18000
># Node ID 43270a80aa51055290ef19b3409d1bac5095e8b8
># Parent  2486cac4cd626a0e199f37948111dbad473a7509
>Move ipa-getkeytab man page into proper subdir
>
>433878
>
>diff -r 2486cac4cd62 -r 43270a80aa51 ipa-admintools/man/Makefile
>--- a/ipa-admintools/man/Makefile	Mon Feb 25 13:11:15 2008 -0500
>+++ b/ipa-admintools/man/Makefile	Mon Feb 25 14:56:09 2008 -0500
>@@ -18,8 +18,7 @@ MANFILES=\
> 	ipa-moddelegation.1 \
> 	ipa-passwd.1 \
> 	ipa-pwpolicy.1 \
>-	ipa-moduser.1 \
>-	ipa-getkeytab.1
>+	ipa-moduser.1
> 
> all: ;
> 
>diff -r 2486cac4cd62 -r 43270a80aa51 ipa-admintools/man/ipa-getkeytab.1
>--- a/ipa-admintools/man/ipa-getkeytab.1	Mon Feb 25 13:11:15 2008 -0500
>+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
>@@ -1,63 +0,0 @@
>-.\" A man page for ipa-getkeytab
>-.\" Copyright (C) 2007 Red Hat, Inc.
>-.\" 
>-.\" This is free software; you can redistribute it and/or modify it under
>-.\" the terms of the GNU Library General Public License as published by
>-.\" the Free Software Foundation; version 2 only
>-.\" 
>-.\" This program is distributed in the hope that it will be useful, but
>-.\" WITHOUT ANY WARRANTY; without even the implied warranty of
>-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
>-.\" General Public License for more details.
>-.\" 
>-.\" You should have received a copy of the GNU Library General Public
>-.\" License along with this program; if not, write to the Free Software
>-.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
>-.\" 
>-.\" Author: Karl MacMillan <kmacmill@redhat.com>
>-.\" 
>-.TH "ipa-getkeytab" "1" "Oct 10 2007" "freeipa" ""
>-.SH "NAME"
>-ipa\-getkeytab \- Get a keytab for a kerberos principal
>-.SH "SYNOPSIS"
>-ipa\-getkeytab [\fI-a\fR] \fIprincipal-name\fR \fIfile-name\fR
>-
>-.SH "DESCRIPTION"
>-Retrieves a kerberos \fIkeytab\fR and optionally adds a
>-service \fIprincipal\fR.
>-
>-Kerberos keytabs are used for services (like sshd) to
>-perform kerberos authentication. A keytab is a file
>-with one or more secrets (or keys) for a kerberos
>-principal.
>-
>-A kerberos service principal is a kerberos identity
>-that can be used for authentication. Service principals
>-contain the name of the service, the hostname of the
>-server, and the realm name. For example, the following
>-is an example principal for an ldap server:
>-
>-   ldap/foo.example.com@EXAMPLE.COM
>-
>-When using ipa-getkeytab the realm name is already
>-provided, so the principal name is just the service
>-name and hostname (ldap/foo.example.com from the 
>-example above).
>-
>-\fBWARNING:\fR retrieving the keytab resets the secret
>-rendering all other keytabs for that principal invalid.
>-
>-.SH "OPTIONS"
>-.TP 
>-\fB\-a\fR
>-Add the service principal in addition to getting the keytab
>-
>-.SH "EXAMPLES"
>-
>-Add and retrieve a keytab for the ldap service principal on
>-the host foo.example.com and save it in the file ldap.keytab.
>-
>-   # ipa-getkeytab -a ldap/foo.example.com ldap.keytab
>-
>-.SH "EXIT STATUS"
>-The exit status is 0 on success, nonzero on error.
>diff -r 2486cac4cd62 -r 43270a80aa51 ipa-client/Makefile.am
>--- a/ipa-client/Makefile.am	Mon Feb 25 13:11:15 2008 -0500
>+++ b/ipa-client/Makefile.am	Mon Feb 25 14:56:09 2008 -0500
>@@ -38,6 +38,7 @@ SUBDIRS =			\
> 	firefox			\
> 	ipaclient		\
> 	ipa-install		\
>+	man			\
> 	$(NULL)
> 
> EXTRA_DIST =			\
>diff -r 2486cac4cd62 -r 43270a80aa51 ipa-client/configure.ac
>--- a/ipa-client/configure.ac	Mon Feb 25 13:11:15 2008 -0500
>+++ b/ipa-client/configure.ac	Mon Feb 25 14:56:09 2008 -0500
>@@ -167,6 +167,7 @@ AC_CONFIG_FILES([
>     firefox/Makefile
>     ipaclient/Makefile
>     ipa-install/Makefile
>+    man/Makefile
> ])
> 
> AC_OUTPUT
>diff -r 2486cac4cd62 -r 43270a80aa51 ipa-client/ipa-client.spec
>--- a/ipa-client/ipa-client.spec	Mon Feb 25 13:11:15 2008 -0500
>+++ b/ipa-client/ipa-client.spec	Mon Feb 25 14:56:09 2008 -0500
>@@ -1,6 +1,6 @@ Name:           ipa-client
> Name:           ipa-client
> Version:        0.99.0
>-Release:        1%{?dist}
>+Release:        2%{?dist}
> Summary:        IPA client
> 
> Group:          System Environment/Base
>@@ -46,7 +46,12 @@ rm -rf %{buildroot}
> %dir %{python_sitelib}/ipaclient
> %{python_sitelib}/ipaclient/*.py*
> 
>+%{_mandir}/man1/*
>+
> %changelog
>+* Mon Feb 25 2008 Rob Crittenden <rcritten@redhat.com> - 0.99.0-2
>+- Add ipa-getkeytab man page
>+
> * Thu Feb 21 2008 Rob Crittenden <rcritten@redhat.com> - 0.99.0-1
> - Version bump for release
> 
>@@ -71,5 +76,3 @@ rm -rf %{buildroot}
> 
> * Thu Aug 16 2007 Simo Sorce <ssorce@redhat.com> - 0.1.0-1
> - Initial rpm version
>-
>-
>diff -r 2486cac4cd62 -r 43270a80aa51 ipa-client/ipa-client.spec.in
>--- a/ipa-client/ipa-client.spec.in	Mon Feb 25 13:11:15 2008 -0500
>+++ b/ipa-client/ipa-client.spec.in	Mon Feb 25 14:56:09 2008 -0500
>@@ -1,6 +1,6 @@ Name:           ipa-client
> Name:           ipa-client
> Version:        VERSION
>-Release:        1%{?dist}
>+Release:        2%{?dist}
> Summary:        IPA client
> 
> Group:          System Environment/Base
>@@ -46,7 +46,12 @@ rm -rf %{buildroot}
> %dir %{python_sitelib}/ipaclient
> %{python_sitelib}/ipaclient/*.py*
> 
>+%{_mandir}/man1/*
>+
> %changelog
>+* Mon Feb 25 2008 Rob Crittenden <rcritten@redhat.com> - 0.99.0-2
>+- Add ipa-getkeytab man page
>+
> * Thu Feb 21 2008 Rob Crittenden <rcritten@redhat.com> - 0.99.0-1
> - Version bump for release
> 
>@@ -71,5 +76,3 @@ rm -rf %{buildroot}
> 
> * Thu Aug 16 2007 Simo Sorce <ssorce@redhat.com> - 0.1.0-1
> - Initial rpm version
>-
>-
>diff -r 2486cac4cd62 -r 43270a80aa51 ipa-client/man/Makefile.am
>--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
>+++ b/ipa-client/man/Makefile.am	Mon Feb 25 14:56:09 2008 -0500
>@@ -0,0 +1,6 @@
>+# This file will be processed with automake-1.7 to create Makefile.in
>+
>+AUTOMAKE_OPTIONS = 1.7
>+
>+man_MANS = ipa-getkeytab.1
>+
>diff -r 2486cac4cd62 -r 43270a80aa51 ipa-client/man/ipa-getkeytab.1
>--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
>+++ b/ipa-client/man/ipa-getkeytab.1	Mon Feb 25 14:56:09 2008 -0500
>@@ -0,0 +1,63 @@
>+.\" A man page for ipa-getkeytab
>+.\" Copyright (C) 2007 Red Hat, Inc.
>+.\" 
>+.\" This is free software; you can redistribute it and/or modify it under
>+.\" the terms of the GNU Library General Public License as published by
>+.\" the Free Software Foundation; version 2 only
>+.\" 
>+.\" This program is distributed in the hope that it will be useful, but
>+.\" WITHOUT ANY WARRANTY; without even the implied warranty of
>+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
>+.\" General Public License for more details.
>+.\" 
>+.\" You should have received a copy of the GNU Library General Public
>+.\" License along with this program; if not, write to the Free Software
>+.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
>+.\" 
>+.\" Author: Karl MacMillan <kmacmill@redhat.com>
>+.\" 
>+.TH "ipa-getkeytab" "1" "Oct 10 2007" "freeipa" ""
>+.SH "NAME"
>+ipa\-getkeytab \- Get a keytab for a kerberos principal
>+.SH "SYNOPSIS"
>+ipa\-getkeytab [\fI-a\fR] \fIprincipal-name\fR \fIfile-name\fR
>+
>+.SH "DESCRIPTION"
>+Retrieves a kerberos \fIkeytab\fR and optionally adds a
>+service \fIprincipal\fR.
>+
>+Kerberos keytabs are used for services (like sshd) to
>+perform kerberos authentication. A keytab is a file
>+with one or more secrets (or keys) for a kerberos
>+principal.
>+
>+A kerberos service principal is a kerberos identity
>+that can be used for authentication. Service principals
>+contain the name of the service, the hostname of the
>+server, and the realm name. For example, the following
>+is an example principal for an ldap server:
>+
>+   ldap/foo.example.com@EXAMPLE.COM
>+
>+When using ipa-getkeytab the realm name is already
>+provided, so the principal name is just the service
>+name and hostname (ldap/foo.example.com from the 
>+example above).
>+
>+\fBWARNING:\fR retrieving the keytab resets the secret
>+rendering all other keytabs for that principal invalid.
>+
>+.SH "OPTIONS"
>+.TP 
>+\fB\-a\fR
>+Add the service principal in addition to getting the keytab
>+
>+.SH "EXAMPLES"
>+
>+Add and retrieve a keytab for the ldap service principal on
>+the host foo.example.com and save it in the file ldap.keytab.
>+
>+   # ipa-getkeytab -a ldap/foo.example.com ldap.keytab
>+
>+.SH "EXIT STATUS"
>+The exit status is 0 on success, nonzero on error.

Actions: View | Diff

Attachments on bug 433878: 295833