Factor out the common text in vos_addsite, vos_copy, and vos_zap
[openafs.git] / doc / man-pages / pod1 / copyauth.pod
1 =head1 NAME
2
3 copyauth - Copies user's AFS credentials to a new cell
4
5 =head1 SYNOPSIS
6
7 =for html
8 <div class="synopsis">
9
10 B<copyauth> S<<< <I<cell name>> >>> 
11
12 =for html
13 </div>
14
15 =head1 DESCRIPTION
16
17 The B<copyauth> command copies existing AFS credentials in the local
18 cell to the foreign cell specified on the command line.  
19
20 The functionality in this command is largely superseded by L<aklog(1)>.
21
22 =head1 CAUTIONS
23
24 This functionality only works if you have a shared AFS key across multiple
25 cells, which is strongly discouraged as it weakens security.  If you do
26 not understand those risks, you should not use this tool.
27
28 =head1 EXAMPLES
29
30    % copyauth other.cell.org
31
32 =head1 PRIVILEGE REQUIRED
33
34 None.
35
36 =head1 SEE ALSO
37
38 L<aklog(1)>,
39 L<tokens(1)>
40
41 =head1 COPYRIGHT
42
43 This documentation was written by Steven Jenkins and is covered 
44 by the IBM Public License Version 1.0.