+
+ This documentation is covered by the IBM Public License Version 1.0. This
+ man page was written by Jason Edgecombe for OpenAFS.
Index: openafs/doc/man-pages/pod1/fs_setcrypt.pod
diff -c /dev/null openafs/doc/man-pages/pod1/fs_setcrypt.pod:1.3.2.4
*** /dev/null Wed Oct 24 01:57:13 2007
--- openafs/doc/man-pages/pod1/fs_setcrypt.pod Sun Aug 5 19:37:14 2007
***************
*** 0 ****
--- 1,98 ----
+ =head1 NAME
+
+ fs setcrypt - Enables of disables the encryption of AFS file transfers
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ B S<<< [B<-crypt>] > >>> [B<-help>]
+
+ =for html
+
+
+ =head1 DESCRIPTION
+
+ The B command sets the status of network traffic encryption
+ for file traffic in the AFS client. This encryption applies to file
+ traffic going to and coming from the AFS File Server for users with valid
+ tokens. This command does not control the encryption used for
+ authentication, which uses Kerberos 5 or klog/kaserver. The complement of
+ this command is B, which shows the status of encryption on
+ the client.
+
+ The default encryption status is enabled.
+
+ This is a global setting and applies to all subsequent connections to an
+ AFS File Server from this Cache Manager. There is no way to enable or
+ disable encryption for specific connections.
+
+ =head1 CAUTIONS
+
+ AFS uses an encryption scheme called fcrypt, based on but slightly weaker
+ than DES, and there is currently no way to specify a different encryption
+ mechanism. Because fcrypt and DES are obsolete, the user must decide how
+ much to trust the encryption. Consider using a Virtual Private Network at
+ the IP level if better encryption is needed.
+
+ Encrypting file traffic requires a token. Unauthenticated connections or
+ connections authorized via IP-based ACLs will not be encrypted even when
+ encryption is turned on.
+
+ =head1 OPTIONS
+
+ =over 4
+
+ =item B<-crypt> >
+
+ This is the only option to B. The B<-crypt> option takes
+ either C or C. C enables encryption. C disables
+ encryption. Since this is the only option, the C<-crypt> flag may be
+ omitted.
+
+ C<0> and C<1> or C and C are not supported as replacements
+ for C and C.
+
+ =item B<-help>
+
+ Prints the online help for this command. All other valid options are
+ ignored.
+
+ =back
+
+ =head1 OUTPUT
+
+ This command produces no output other than error messages.
+
+ =head1 EXAMPLES
+
+ There are only four ways to invoke B. Either of:
+
+ % fs setcrypt -crypt on
+ % fs setcrypt on
+
+ will enable encryption for authenticated connections and:
+
+ % fs setcrypt -crypt off
+ % fs setcrypt off
+
+ will disable encryption.
+
+ =head1 PRIVILEGE REQUIRED
+
+ The issuer must be logged in as the local superuser root.
+
+ =head1 SEE ALSO
+
+ L
+
+ The description of the fcrypt encryption mechanism at
+ L.
+
+ =head1 COPYRIGHT
+
+ Copyright 2007 Jason Edgecombe
+
+ This documentation is covered by the IBM Public License Version 1.0. This
+ man page was written by Jason Edgecombe for OpenAFS.
Index: openafs/doc/man-pages/pod1/fs_uuid.pod
diff -c /dev/null openafs/doc/man-pages/pod1/fs_uuid.pod:1.1.4.2
*** /dev/null Wed Oct 24 01:57:13 2007
--- openafs/doc/man-pages/pod1/fs_uuid.pod Tue Oct 23 13:04:23 2007
***************
*** 0 ****
--- 1,82 ----
+ =head1 NAME
+
+ fs uuid - Prints the uuid of the client or generates a new one
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ B [B<-generate>] [B<-help>]
+
+ =for html
+
+
+ =head1 DESCRIPTION
+
+ B prints the current uuid of an OpenAFS client. It can
+ optionally force the generation of a new uuid, if needed. The client
+ uuid is used by the B to differentiate clients with the
+ same IP address.
+
+ =head1 CAUTIONS
+
+ The B command is only available in OpenAFS versions after
+ 1.4.5 and 1.5.8. The behavior differs slightly between versions. In
+ OpenAFS 1.4.5 and later, the B<-generate> option is required and the
+ uuid for the client machine is never printed. OpenAFS versions 1.5.8
+ and later will print the uuid.
+
+ =head1 OPTIONS
+
+ =over 4
+
+ =item B<-generate>
+
+ Generates a new uuid for the cache manager. This is useful if two
+ clients share the same uuid. B<-generate> is optional in OpenAFS
+ versions 1.5.8 and later, but it is required in OpenAFS versions 1.4.5
+ and later.
+
+ =item B<-help>
+
+ Prints the online help for this command. All other valid options are
+ ignored.
+
+ =back
+
+ =head1 OUTPUT
+
+ B prints out the current uuid for the client or the new uuid
+ if the B<-generate> option is passed to it.
+
+ =head1 EXAMPLES
+
+ There are only two ways to invoke B under 1.5.8 and later:
+
+ % fs uuid
+ UUID: 8ac66f9308a8e-47d7-80f7-50d0040cddc2
+
+ % fs uuid -generate
+ New UUID: 436bd660-1720-429508e470cff38f5c6fb0
+
+ Here is the only way to invoke B under OpenAFS 1.4.5 and later:
+
+ % fs uuid -generate
+ New uuid generated.
+
+
+ =head1 PRIVILEGE REQUIRED
+
+ The issuer must be logged on as the local superuser C.
+
+ =head1 SEE ALSO
+
+ L
+
+ =head1 COPYRIGHT
+
+ Copyright 2007 Jason Edgecombe
+
+ This documentation is covered by the IBM Public License Version 1.0. This
+ man page was written by Jason Edgecombe for OpenAFS.
Index: openafs/doc/man-pages/pod1/klog.pod
diff -c openafs/doc/man-pages/pod1/klog.pod:1.3.2.5 openafs/doc/man-pages/pod1/klog.pod:1.3.2.6
*** openafs/doc/man-pages/pod1/klog.pod:1.3.2.5 Wed Mar 1 00:11:20 2006
--- openafs/doc/man-pages/pod1/klog.pod Fri Jul 27 14:02:03 2007
***************
*** 49,56 ****
credential structure already contains a token for the requested cell, the
token resulting from this command replaces it.
! Sites that employ standard Kerberos authentication instead of the AFS
! Authentication Server must use the Kerberos version of this command,
B, on all client machines. It automatically places the issuer's
Kerberos tickets in the file named by the KRBTKFILE environment variable,
which the B command defines automatically as F>
--- 49,60 ----
credential structure already contains a token for the requested cell, the
token resulting from this command replaces it.
! Sites that employ Kerberos authentication instead of the AFS
! Authentication Server should normally use the combination of B and
! B instead of B.
!
! Sites using Kerberos v4 authentication (perhaps with the AFS
! Authentication Server) must use the Kerberos version of this command,
B, on all client machines. It automatically places the issuer's
Kerberos tickets in the file named by the KRBTKFILE environment variable,
which the B command defines automatically as F>
Index: openafs/doc/man-pages/pod1/pts.pod
diff -c openafs/doc/man-pages/pod1/pts.pod:1.2.2.3 openafs/doc/man-pages/pod1/pts.pod:1.2.2.4
*** openafs/doc/man-pages/pod1/pts.pod:1.2.2.3 Thu Jan 5 13:33:53 2006
--- openafs/doc/man-pages/pod1/pts.pod Fri Aug 17 21:48:14 2007
***************
*** 52,57 ****
--- 52,66 ----
=item *
+ Commands to run commands interactively: B, B, and B.
+
+ =item *
+
+ A command to run commands from a file: B.
+
+ =item *
+
Commands to obtain help: B and B.
=back
***************
*** 136,149 ****
L,
L,
L,
L,
L,
L,
L,
L,
L,
L,
! L
=head1 COPYRIGHT
--- 145,162 ----
L,
L,
L,
+ L,
L,
L,
L,
L,
+ L,
L,
L,
L,
! L,
! L,
! L
=head1 COPYRIGHT
Index: openafs/doc/man-pages/pod1/pts_interactive.pod
diff -c /dev/null openafs/doc/man-pages/pod1/pts_interactive.pod:1.2.2.2
*** /dev/null Wed Oct 24 01:57:13 2007
--- openafs/doc/man-pages/pod1/pts_interactive.pod Fri Aug 17 22:47:28 2007
***************
*** 0 ****
--- 1,119 ----
+ =head1 NAME
+
+ pts interactive - Enters interactive mode
+
+ =head1 SYNOPSIS
+
+ =for html
+
+
+ B
S<<< [B<-cell>] > >>> [B<-noauth>]
+ [B<-force>]
+
+ B S<<< [B<-c>] > >>> [B<-n>] [B<-f>]
+
+ =for html
+
+
+ B
S<<< [B<-cell>] > >>> [B<-noauth>] [B<-force>]
+
+ B S<<< [B<-c>] > >>> [B<-n>] [B<-f>]
+
+ =for html
+
+
+ B
S<<< [B<-delay>] > >>>
+ S<<< [B<-cell>] > >>> [B<-noauth>] [B<-force>]
+
+ B S<<< [B<-d>] > >>> S<<< [B<-c>] > >>>
+ [B<-n>] [B<-f>]
+
+ =for html
+
+
+ B
S<<< [B<-file>] > >>> S<<< [B<-cell>] > >>>
+ [B<-noauth>] [B<-force>]
+
+ B S<<< [B<-f>] > >>> S<<< [B<-c>] > >>>
+ [B<-n>] [B<-f>]
+
+ =for html
+