From: Steven Jenkins <steven@endpoint.com>
Date: Tue, 19 May 2009 00:33:32 +0000 (+0000)
Subject: STABLE14-man-page-copyauth-20090518
X-Git-Tag: openafs-stable-1_4_11pre1~42
X-Git-Url: https://git.michaelhowe.org/gitweb/?a=commitdiff_plain;h=e494a4c7eafbc326abdba3b604d26ff6452fd9bf;p=packages%2Fo%2Fopenafs.git

STABLE14-man-page-copyauth-20090518

FIXES 124789
LICENSE IPL10

Add man page for copyauth.


(cherry picked from commit a7a80efd577d9f2a9573fe35c12ca30b59e2f375)
---

diff --git a/doc/man-pages/README b/doc/man-pages/README
index 5ff261fee..862d12935 100644
--- a/doc/man-pages/README
+++ b/doc/man-pages/README
@@ -231,7 +231,6 @@ Known Problems
 
    * The following installed commands have no man pages:
 
-       copyauth
        fs monitor
        klog.krb
        krb.conf
diff --git a/doc/man-pages/pod1/copyauth.pod b/doc/man-pages/pod1/copyauth.pod
new file mode 100644
index 000000000..a578acdc0
--- /dev/null
+++ b/doc/man-pages/pod1/copyauth.pod
@@ -0,0 +1,44 @@
+=head1 NAME
+
+copyauth - Copies user's AFS credentials to a new cell
+
+=head1 SYNOPSIS
+
+=for html
+<div class="synopsis">
+
+B<copyauth> S<<< <I<cell name>> >>> 
+
+=for html
+</div>
+
+=head1 DESCRIPTION
+
+The B<copyauth> command copies existing AFS credentials in the local
+cell to the foreign cell specified on the command line.  
+
+The functionality in this command is largely superseded by L<aklog(1)>.
+
+=head1 CAUTIONS
+
+This functionality only works if you have a shared AFS key across multiple
+cells, which is strongly discouraged as it weakens security.  If you do
+not understand those risks, you should not use this tool.
+
+=head1 EXAMPLES
+
+   % copyauth other.cell.org
+
+=head1 PRIVILEGE REQUIRED
+
+None.
+
+=head1 SEE ALSO
+
+L<aklog(1)>,
+L<tokens(1)>
+
+=head1 COPYRIGHT
+
+This documentation was written by Steven Jenkins and is covered 
+by the IBM Public License Version 1.0.