IntenseWebs/freeipa
3
0
Fork 0
mirror of https://salsa.debian.org/freeipa-team/freeipa.git synced 2025-02-25 18:55:28 -06:00
Code Issues Packages Projects Releases Wiki Activity

Move ipa-getkeytab man page into proper subdir

Browse Source 
433878
This commit is contained in:
Rob Crittenden
2008-02-25 14:56:09 -05:00
parent 02d3c5aff3
commit 6d759d7dcb
7 changed files with 21 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
ipa-client/Makefile.am
View File

@@ -38,6 +38,7 @@ SUBDIRS = \
firefox \
ipaclient \
ipa-install \
man \
$(NULL)
EXTRA_DIST = \

1
ipa-client/configure.ac
View File

@@ -167,6 +167,7 @@ AC_CONFIG_FILES([
firefox/Makefile
ipaclient/Makefile
ipa-install/Makefile
man/Makefile
])
AC_OUTPUT

9
ipa-client/ipa-client.spec
View File

@@ -1,6 +1,6 @@
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

9
ipa-client/ipa-client.spec.in
View File

@@ -1,6 +1,6 @@
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

6
ipa-client/man/Makefile.am Normal file
View File

@@ -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

63
ipa-client/man/ipa-getkeytab.1 Normal file
View File

@@ -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.