The following example illustrates the different parts of a command that
belongs to an AFS command suite.
- % bos getdate -server fs1.abc.com -file ptserver kaserver
+ % bos getdate -server fs1.abc.com -file ptserver kaserver
where
first line (short description) for every operation code in the suite:
% <command_suite> help
-
+
If the issuer specifies one or more operation codes, the B<help> operation
code displays each command's complete online entry (short description,
alias if any, and syntax):
The B<-help> flag displays a command's syntax but not the short
description or alias:
- % <command_name> -help
+ % <command_name> -help
The apropos operation code displays the short description of any command
in a suite whose operation code or short description includes the
The following example command displays the complete online help entry for
the B<fs setacl> command:
- % fs help setacl
+ % fs help setacl
fs setacl: set access control list
aliases: sa
- Usage: fs setacl -dir <directory>+ -acl <access list entries>+
+ Usage: fs setacl -dir <directory>+ -acl <access list entries>+
[-clear] [-negative] [-id] [-if] [-help]
To see only the syntax statement, use the B<-help> flag:
% fs setacl -help
- Usage: fs setacl -dir <directory>+ -acl <access list entries>+
+ Usage: fs setacl -dir <directory>+ -acl <access list entries>+
[-clear] [-negative] [-id] [-if] [-help]
In the following example, a user wants to display the quota for her home
B<afsmonitor> [B<initcmd>] [-config <I<configuration file>>]
[B<-frequency> <I<poll frequency, in seconds>>]
- [B<-output> <I<storage file name>>] [B<-detailed>]
+ [B<-output> <I<storage file name>>] [B<-detailed>]
[B<-debug> <I<debug output file>>]
[B<-fshosts> <I<list of file servers to monitor>>+]
[B<-cmhosts> <I<list of cache managers to monitor>>+]
=head1 SYNOPSIS
-B<dlog> [B<-principal> <I<user name>>] [B<-cell> <I<cell name>>]
+B<dlog> [B<-principal> <I<user name>>] [B<-cell> <I<cell name>>]
[B<-password> <I<user's password>>]
- [B<-servers> <I<explicit list of servers>>+]
- [B<-lifetime> <I<ticket lifetime in hh[:mm[:ss]]>>]
+ [B<-servers> <I<explicit list of servers>>+]
+ [B<-lifetime> <I<ticket lifetime in hh[:mm[:ss]]>>]
[B<-setpag>] [B<-pipe>] [B<-help>]
B<dlog> [B<-pr> <I<user name>>] [B<-c> <I<cell name>>]
- [B<-pw> <I<user's password>>]
- [B<-ser> <I<explicit list of servers>>+]
+ [B<-pw> <I<user's password>>]
+ [B<-ser> <I<explicit list of servers>>+]
[B<-l> <I<ticket lifetime in hh[:mm[:ss]]>>]
[B<-set>] [B<-pi>] [B<-h>]
% tokens
Tokens held by the Cache Manager:
-
- User's (AFS ID 1) tokens for afs@dce.abc.com [Expires Jul 6 14:12]
- User's (AFS ID 4758) tokens for afs@abc.com [Expires Jul 2 13:14]
-
+
+ User's (AFS ID 1) tokens for afs@dce.abc.com [Expires Jul 6 14:12]
+ User's (AFS ID 4758) tokens for afs@abc.com [Expires Jul 2 13:14]
+
--End of list--
=head1 PRIVILEGE REQUIRED
By default, the dpass command writes a message similar to the following to
the standard output stream.
- Please read the following message before entering your password.
+ Please read the following message before entering your password.
This program will display your new, temporary DCE password on your
terminal, and you should change the assigned password as soon as
B<fs checkservers> [B<-cell> <I<cell to check>>] [B<-all>] [B<-fast>]
[B<-interval> <I<seconds between probes>>] [B<-help>]
-B<fs checks> [B<-c> <I<cell to check>>] [B<-a>] [B<-f>]
+B<fs checks> [B<-c> <I<cell to check>>] [B<-a>] [B<-f>]
[B<-i> <I<seconds between probes>>] [B<-h>]
=head1 DESCRIPTION
B<fs cleanacl> [B<-path> <I<dir/file path>>+] [B<-help>]
-B<fs cl> [B<-p> <I<dir/file path>>+] [B<-h>]
+B<fs cl> [B<-p> <I<dir/file path>>+] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
-B<fs copyacl> B<-fromdir> <I<source directory (or DFS file)>>
- B<-todir> <I<destination directory (or DFS file)>>+
+B<fs copyacl> B<-fromdir> <I<source directory (or DFS file)>>
+ B<-todir> <I<destination directory (or DFS file)>>+
[B<-clear>] [B<-id>] [B<-if>] [-help]
-B<fs co> B<-f> <I<source directory (or DFS file)>>
- B<-t> <I<destination directory (or DFS file)>>+
+B<fs co> B<-f> <I<source directory (or DFS file)>>
+ B<-t> <I<destination directory (or DFS file)>>+
[B<-c>] [B<-id>] [B<-if>] [-h]
=head1 DESCRIPTION
jones rlidwka
% fs copyacl -fromdir . -todir reports
-
+
% fs listacl . reports
Access list for . is
Normal rights:
volumes C<user.smith> and C<sun4x_56.bin>:
% fs diskfree -path /afs/abc.com/usr/smith /afs/abc.com/sun4x_56/bin
- Volume Name kbytes used avail %used
+ Volume Name kbytes used avail %used
user.smith 4177920 3841258 336662 92% <<WARNING
sun4x_56.bin 4423680 3174500 1249180 72%
B<fs examine> [B<-path> <I<dir/file path>>+] [B<-help>]
-B<fs exa> [B<-p> <I<dir/file path>>+] [B<-h>]
+B<fs exa> [B<-p> <I<dir/file path>>+] [B<-h>]
-B<fs listvol> [B<-p> <I<dir/file path>>+] [B<-h>]
+B<fs listvol> [B<-p> <I<dir/file path>>+] [B<-h>]
-B<fs listv> [B<-p> <I<dir/file path>>+] [B<-h>]
+B<fs listv> [B<-p> <I<dir/file path>>+] [B<-h>]
B<fs lv> [B<-p> <I<dir/file path>>+] [B<-h>]
Volume status for vid = 50489902 named user.smith
Current maximum quota is 15000
Current blocks used are 5073
- The partition has 336662 blocks available out of 4177920
+ The partition has 336662 blocks available out of 4177920
=head1 PRIVILEGE REQUIRED
=head1 SYNOPSIS
-B<fs exportafs> B<-type> <I<exporter name>>
- [B<-start> <I<start/stop translator (on | off)>>]
- [B<-convert> <I<convert from afs to unix mode (on | off)>>]
- [B<-uidcheck> <I<run on strict 'uid check' mode (on | off)>>]
+B<fs exportafs> B<-type> <I<exporter name>>
+ [B<-start> <I<start/stop translator (on | off)>>]
+ [B<-convert> <I<convert from afs to unix mode (on | off)>>]
+ [B<-uidcheck> <I<run on strict 'uid check' mode (on | off)>>]
[B<-submounts> <I<allow nfs mounts to subdirs of /afs/.. (on | off)>>]
[B<-help>]
-B<fs exp> B<-t> <I<exporter name>>
+B<fs exp> B<-t> <I<exporter name>>
[B<-st> <I<start/stop translator (on | off)>>]
[B<-c> <I<convert from afs to unix mode (on | off)>>]
[B<-u> <I<run on strict 'uid check' mode (on | off)>>]
- [B<-su> <I<allow nfs mounts to subdirs of /afs/.. (on | off)>>]
+ [B<-su> <I<allow nfs mounts to subdirs of /afs/.. (on | off)>>]
[B<-h>]
=head1 DESCRIPTION
The following command flushes from the cache all data fetched from the
volume that contains the current working directory:
- % fs flushvolume
+ % fs flushvolume
=head1 PRIVILEGE REQUIRED
=head1 SYNOPSIS
-B<fs getserverprefs> [B<-file> <I<output to named file>>]
+B<fs getserverprefs> [B<-file> <I<output to named file>>]
[B<-numeric>] [B<-vlservers>] [B<-help>]
B<fs gets> [B<-f> <I<output to named file>>] [B<-n>] [B<-v>] [B<-h>]
% fs help setacl
fs setacl: set access control list
- aliases: sa
- Usage: fs setacl -dir <directory>+
+ aliases: sa
+ Usage: fs setacl -dir <directory>+
-acl <access list entries>+ [-clear] [-negative] [-help]
=head1 PRIVILEGE REQUIRED
B<fs listacl> [B<-path> <I<dir/file path>>+] [B<-id>] [B<-if>] [B<-help>]
-B<fs la> [B<-p> <I<dir/file path>>+] [B<-id>] [B<-if>] [B<-h>]
+B<fs la> [B<-p> <I<dir/file path>>+] [B<-id>] [B<-if>] [B<-h>]
-B<fs lista> [B<-p> <I<dir/file path>>+] [B<-id>] [B<-if>] [B<-h>]
+B<fs lista> [B<-p> <I<dir/file path>>+] [B<-id>] [B<-if>] [B<-h>]
=head1 DESCRIPTION
% fs listcells
Cell abc.com on hosts fs1.abc.com fs2.abc.com fs3.abc.com
- Cell stateu.edu on hosts DB1.FS.STATEU.EDU
+ Cell stateu.edu on hosts DB1.FS.STATEU.EDU
DB2.FS.STATEU.EDU DB3.FS.STATEU.EDU
Cell def.gov on hosts 138.255.0.2 sv3.def.gov
The following example shows the output for the volume C<user.smith>:
% fs listquota -path /afs/abc.com/usr/smith
- Volume Name Quota Used % Used Partition
- user.smith 15000 5071 34% 86%
+ Volume Name Quota Used % Used Partition
+ user.smith 15000 5071 34% 86%
=head1 PRIVILEGE REQUIRED
B<fs lsmount> B<-dir> <I<directory>>+ [B<-help>]
-B<fs ls -d> <I<directory>>+ [B<-h>]
+B<fs ls -d> <I<directory>>+ [B<-h>]
=head1 DESCRIPTION
'<directory>' is a mount point for volume '<volume name>'
-where
+where
=over 4
=head1 SYNOPSIS
-B<fs setacl> B<-dir> <I<directory>>+ B<-acl> <I<access list entries>>+
+B<fs setacl> B<-dir> <I<directory>>+ B<-acl> <I<access list entries>>+
[B<-clear>] [B<-negative>] [B<-id>] [B<-if>] [B<-help>]
-B<fs sa> B<-d> <I<directory>>+ B<-a> <I<access list entries>>+
- [B<-c>] [B<-n>] [B<-id>] [B<-if>] [B<-h>]
-
-B<fs seta> B<-d> <I<directory>>+ B<-a> <I<access list entries>>+
+B<fs sa> B<-d> <I<directory>>+ B<-a> <I<access list entries>>+
+ [B<-c>] [B<-n>] [B<-id>] [B<-if>] [B<-h>]
+
+B<fs seta> B<-d> <I<directory>>+ B<-a> <I<access list entries>>+
[B<-c>] [B<-n>] [B<-id>] [B<-if>] [B<-h>]
=head1 DESCRIPTION
terry rl
% fs setacl -clear -dir reports -acl pat all smith write system:anyuser rl
-
+
% fs listacl -dir reports
Access list for reports is
Normal rights:
=head1 SYNOPSIS
-B<fs setcachesize> [B<-blocks> <I<size in 1K byte blocks (0 => reset)>>]
+B<fs setcachesize> [B<-blocks> <I<size in 1K byte blocks (0 => reset)>>]
[B<-reset>] [B<-help>]
B<fs setca> [B<-b> <I<size in 1K byte blocks (0 => reset)>>]
[B<-r>] [B<-h>]
B<fs ca> [B<-b> <I<size in 1K byte blocks (0 => reset)>>]
- [B<-r>] [B<-h>]
+ [B<-r>] [B<-h>]
=head1 DESCRIPTION
B<fs setquota> [B<-path> <I<dir/file path>>]
B<-max> <I<max quota in kbytes>> [B<-help>]
-B<fs setq> [B<-p> <I<dir/file path>>] B<-m> <I<max quota in kbytes>> [B<-h>]
+B<fs setq> [B<-p> <I<dir/file path>>] B<-m> <I<max quota in kbytes>> [B<-h>]
-B<fs sq> [B<-p> <I<dir/file path>>] B<-m> <I<max quota in kbytes>> [B<-h>]
+B<fs sq> [B<-p> <I<dir/file path>>] B<-m> <I<max quota in kbytes>> [B<-h>]
=head1 DESCRIPTION
B<fs sets> [B<-se> <I<fileserver names and ranks>>+]
[B<-vl> <I<VL server names and ranks>>+]
[B<-f> <I<input from named file>>] [B<-st>] [B<-h>]
-
+
B<fs sp> [B<-se> <I<fileserver names and ranks>>+]
- [B<-vl> <I<VL server names and ranks>>+]
+ [B<-vl> <I<VL server names and ranks>>+]
[B<-f> <I<input from named file>>] [B<-st>] [B<-h>]
=head1 DESCRIPTION
[B<-offlinemsg> <I<offline message>>] [B<-help>]
B<fs setv> [B<-p> <I<dir/file path>>+]
- [B<-ma> <I<disk space quota in 1K units>>]
+ [B<-ma> <I<disk space quota in 1K units>>]
[B<-o> <I<offline message>>] [B<-h>]
-
+
B<fs sv> [B<-p> <I<dir/file path>>+]
- [B<-ma> <I<disk space quota in 1K units>>]
+ [B<-ma> <I<disk space quota in 1K units>>]
[B<-o> <I<offline message>>] [B<-h>]
=head1 DESCRIPTION
[B<-allfiles> <I<new default (KB)>>] [B<-verbose>] [B<-help>]
B<fs st> [B<-k> <I<asynchrony for specified names>>]
- [B<-f> <I<specific pathnames>>+]
+ [B<-f> <I<specific pathnames>>+]
[B<-a> <I<new default (KB)>>] [B<-v>] [B<-h>]
=head1 DESCRIPTION
B<klog> [B<-x>] [B<-principal> <I<user name>>]
[-password <I<user's password>>] [B<-cell> <I<cell name>>]
- [B<-servers> <I<explicit list of servers>>+]
+ [B<-servers> <I<explicit list of servers>>+]
[B<-pipe>] [B<-silent>]
- [B<-lifetime> <I<ticket lifetime in hh[:mm[:ss]]>>]
+ [B<-lifetime> <I<ticket lifetime in hh[:mm[:ss]]>>]
[B<-setpag>] [B<-tmp>] [B<-help>]
B<klog> [B<-x>] [B<-pr> <I<user name>>] [B<-pa> <I<user's password>>]
hours (C<11d 18h>). The Authentication Server rounds up a requested
lifetime to the next highest possible lifetime.
- 11:24:15 (0d 11h) 46:26:01 (1d 22h) 189:03:38 (7d 21h)
- 12:11:34 (0d 12h) 49:38:40 (2d 01h) 202:08:00 (8d 10h)
- 13:02:09 (0d 13h) 53:04:37 (2d 05h) 216:06:35 (9d 00h)
- 13:56:14 (0d 13h) 56:44:49 (2d 08h) 231:03:09 (9d 15h)
- 14:54:03 (0d 14h) 60:40:15 (2d 12h) 247:01:43 (10d 07h)
- 15:55:52 (0d 15h) 64:51:57 (2d 16h) 264:06:34 (11d 00h)
- 17:01:58 (0d 17h) 69:21:04 (2d 21h) 282:22:17 (11d 18h)
- 18:12:38 (0d 18h) 74:08:46 (3d 02h) 301:53:45 (12d 13h)
- 19:28:11 (0d 19h) 79:16:23 (3d 07h) 322:46:13 (13d 10h)
- 20:48:57 (0d 20h) 84:45:16 (3d 12h) 345:05:18 (14d 09h)
- 22:15:19 (0d 22h) 90:36:53 (3d 18h) 368:56:58 (15d 08h)
- 23:47:38 (0d 23h) 96:52:49 (4d 00h) 394:27:37 (16d 10h)
- 25:26:21 (1d 01h) 103:34:45 (4d 07h) 421:44:07 (17d 13h)
- 27:11:54 (1d 03h) 110:44:28 (4d 14h) 450:53:46 (18d 18h)
- 29:04:44 (1d 05h) 118:23:54 (4d 22h) 482:04:24 (20d 02h)
- 31:05:22 (1d 07h) 126:35:05 (5d 06h) 515:24:22 (21d 11h)
- 33:14:21 (1d 09h) 135:20:15 (5d 15h) 551:02:38 (22d 23h)
- 35:32:15 (1d 11h) 144:41:44 (6d 00h) 589:08:45 (24d 13h)
- 37:59:41 (1d 13h) 154:42:01 (6d 10h) 629:52:56 (26d 05h)
+ 11:24:15 (0d 11h) 46:26:01 (1d 22h) 189:03:38 (7d 21h)
+ 12:11:34 (0d 12h) 49:38:40 (2d 01h) 202:08:00 (8d 10h)
+ 13:02:09 (0d 13h) 53:04:37 (2d 05h) 216:06:35 (9d 00h)
+ 13:56:14 (0d 13h) 56:44:49 (2d 08h) 231:03:09 (9d 15h)
+ 14:54:03 (0d 14h) 60:40:15 (2d 12h) 247:01:43 (10d 07h)
+ 15:55:52 (0d 15h) 64:51:57 (2d 16h) 264:06:34 (11d 00h)
+ 17:01:58 (0d 17h) 69:21:04 (2d 21h) 282:22:17 (11d 18h)
+ 18:12:38 (0d 18h) 74:08:46 (3d 02h) 301:53:45 (12d 13h)
+ 19:28:11 (0d 19h) 79:16:23 (3d 07h) 322:46:13 (13d 10h)
+ 20:48:57 (0d 20h) 84:45:16 (3d 12h) 345:05:18 (14d 09h)
+ 22:15:19 (0d 22h) 90:36:53 (3d 18h) 368:56:58 (15d 08h)
+ 23:47:38 (0d 23h) 96:52:49 (4d 00h) 394:27:37 (16d 10h)
+ 25:26:21 (1d 01h) 103:34:45 (4d 07h) 421:44:07 (17d 13h)
+ 27:11:54 (1d 03h) 110:44:28 (4d 14h) 450:53:46 (18d 18h)
+ 29:04:44 (1d 05h) 118:23:54 (4d 22h) 482:04:24 (20d 02h)
+ 31:05:22 (1d 07h) 126:35:05 (5d 06h) 515:24:22 (21d 11h)
+ 33:14:21 (1d 09h) 135:20:15 (5d 15h) 551:02:38 (22d 23h)
+ 35:32:15 (1d 11h) 144:41:44 (6d 00h) 589:08:45 (24d 13h)
+ 37:59:41 (1d 13h) 154:42:01 (6d 10h) 629:52:56 (26d 05h)
40:37:19 (1d 16h) 165:23:50 (6d 21h) 673:26:07 (28d 01h)
43:25:50 (1d 19h) 176:50:01 (7d 08h)
including the B<-uidcheck on> argument to the B<fs exportafs> command, the
command fails with an error message similar to the following:
- Warning: Remote pioctl to <translator_machine> has failed (err=8). . .
+ Warning: Remote pioctl to <translator_machine> has failed (err=8). . .
Unable to authenticate to AFS because a pioctl failed.
Enabling UID checking means that the credential structure in which tokens
Database entry was created in AFS 3.1 or later).
% klog
- Password:
+ Password:
The following example authenticates the user as admin in the ABC
Corporation's test cell:
% klog -principal admin -cell test.abc.com
- Password:
+ Password:
In the following, the issuer requests a ticket lifetime of 104 hours 30
minutes (4 days 8 hours 30 minutes). Presuming that this lifetime is
largest possible value.
% klog -lifetime 104:30
- Password:
+ Password:
=head1 PRIVILEGE REQUIRED
[B<-sysname> <I<host's '@sys' value>>] [B<-unlog>] [B<-tokens>]
[B<-help>]
-B<knfs> B<-ho> <I<host name>> [B<-i> <I<user ID (decimal)>>]
+B<knfs> B<-ho> <I<host name>> [B<-i> <I<user ID (decimal)>>]
[B<-s> <I<host's '@sys' value>>] [B<-u>] [B<-t>] [B<-he>]
=head1 DESCRIPTION
% klog admin -cell test.abc.com
Password:
-
+
% knfs nfscli1.abc.com 1020
-
+
% exit
The following example shows user smith again connecting to the machine
AFS(R) login
% knfs nfscli1.abc.com 1020 -unlog
-
+
% exit
=head1 PRIVILEGE REQUIRED
[B<-newpassword> <I<user's new password>>] [B<-cell> <I<cell name>>]
[B<-servers> <I<explicit list of servers>>+] [B<-pipe>] [B<-help>]
-B<kpasswd> [B<-x>] [B<-pr> <I<user name>>] [B<-pa> <I<user's password>>]
- [B<-n> <I<user's new password>>] [B<-c> <I<cell name>>]
+B<kpasswd> [B<-x>] [B<-pr> <I<user name>>] [B<-pa> <I<user's password>>]
+ [B<-n> <I<user's new password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of servers>>+] [B<-pi>] [B<-h>]
=head1 DESCRIPTION
command. The following error message appears if a user attempts to change
a password before the minimum time has passed:
- Password was not changed because you changed it too
+ Password was not changed because you changed it too
recently; see your systems administrator
=back
the cell name to the shortest form that distinguishes it from the other
cells listed in the local F</usr/vice/etc/CellServDB> file.
-By default, the command is executed in the local cell, as defined
+By default, the command is executed in the local cell, as defined
=over 4
checking by including the B<-uidcheck on> argument to the B<fs exportafs>
command, the command fails with an error message similar to the following:
- Warning: Remote setpag to <translator_machine> has failed (err=8). . .
+ Warning: Remote setpag to <translator_machine> has failed (err=8). . .
setpag: Exec format error
=head1 EXAMPLES
=head1 SYNOPSIS
-B<pts adduser> B<-user> <I<user name>>+ B<-group> <I<group name>>+
+B<pts adduser> B<-user> <I<user name>>+ B<-group> <I<group name>>+
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-force>] [B<-help>]
B<pts ad> B<-u> <I<user name>>+ B<-g> <I<group name>>+
=head1 SYNOPSIS
-B<pts chown> B<-name> <I<group name>> B<-owner> <I<new owner>>
+B<pts chown> B<-name> <I<group name>> B<-owner> <I<new owner>>
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-force>] [B<-help>]
B<pts cho> B<-na> <I<group name>> B<-o> <I<new owner>>
=head1 SYNOPSIS
B<pts creategroup> B<-name> <I<group name>>+
- [B<-owner> <I<owner of the group>>]
- [B<-id> <I<id (negated) for the group>>+] [B<-cell> <I<cell name>>]
+ [B<-owner> <I<owner of the group>>]
+ [B<-id> <I<id (negated) for the group>>+] [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-force>] [B<-help>]
-B<pts createg> B<-na> <I<group name>>+ [B<-o> <I<owner of the group>>]
- [B<-i> <I<id (negated) for the group>>+] [B<-c> <I<cell name>>]
+B<pts createg> B<-na> <I<group name>>+ [B<-o> <I<owner of the group>>]
+ [B<-i> <I<id (negated) for the group>>+] [B<-c> <I<cell name>>]
[B<-no>] [B<-f>] [B<-h>]
-
-B<pts cg> B<-na> <I<group name>>+ [B<-o> <I<owner of the group>>]
+
+B<pts cg> B<-na> <I<group name>>+ [B<-o> <I<owner of the group>>]
[B<-i> <I<id (negated) for the group>>+] [B<-c> <I<cell name>>]
[B<-no>] [B<-f>] [B<-h>]
B<pts createu> B<-na> <I<user name>>+ [B<-i> <I<user id>>+]
[B<-c> <I<cell name>>] [B<-no>] [B<-f>] [B<-h>]
-
+
B<pts cu> B<-na> <I<user name>>+ [B<-i> <I<user id>>+]
[B<-c> <I<cell name>>] [B<-no>] [B<-f>] [B<-h>]
B<pts e> B<-na> <I<user or group name or id>>+ [B<-c> <I<cell name>>]
[B<-no>] [B<-f>] [B<-h>]
-B<pts check> B<-na> <I<user or group name or id>>+ [B<-c> <I<cell name>>]
+B<pts check> B<-na> <I<user or group name or id>>+ [B<-c> <I<cell name>>]
[B<-no>] [B<-f>] [B<-h>]
-
-B<pts che> B<-na> <I<user or group name or id>>+ [B<-c> <I<cell name>>]
+
+B<pts che> B<-na> <I<user or group name or id>>+ [B<-c> <I<cell name>>]
[B<-no>] [B<-f>] [B<-h>]
=head1 DESCRIPTION
=item Name
-The contents of this field depend on the type of entry:
+The contents of this field depend on the type of entry:
=over 4
entry C<158.12.105.44>.
% pts examine terry 158.12.105.44
- Name: terry, id: 1045, owner: system:administrators, creator: admin,
+ Name: terry, id: 1045, owner: system:administrators, creator: admin,
membership: 9, flags: S----, group quota: 15.
- Name: 158.12.105.44, id: 5151, owner: system:administrators,
+ Name: 158.12.105.44, id: 5151, owner: system:administrators,
creator: byu, membership: 1, flags: S----, group quota: 20.
The following example displays the entries for the AFS groups with GIDs
-673 and -674.
% pts examine -673 -674
- Name: terry:friends, id: -673, owner: terry, creator: terry,
+ Name: terry:friends, id: -673, owner: terry, creator: terry,
membership: 5, flags: S-M--, group quota: 0.
- Name: smith:colleagues, id: -674, owner: smith, creator: smith,
+ Name: smith:colleagues, id: -674, owner: smith, creator: smith,
membership: 14, flags: SOM--, group quota: 0.
=head1 PRIVILEGE REQUIRED
% pts help membership
pts membership: list membership of a user or group
aliases: groups
- Usage: pts membership -nameorid <user or group name or id>+
+ Usage: pts membership -nameorid <user or group name or id>+
[-cell <cell name>] [-noauth] [-force] [-help]
=head1 PRIVILEGE REQUIRED
% pts listentries -users -groups
Name ID Owner Creator
- system:administrators -204 -204 -204
- system:anyuser -101 -204 -204
- system:authuser -102 -204 -204
- anonymous 32766 -204 -204
- admin 1 -204 32766
- pat 100 -204 1
- smith 101 -204 1
- pat:friends -206 100 100
+ system:administrators -204 -204 -204
+ system:anyuser -101 -204 -204
+ system:authuser -102 -204 -204
+ anonymous 32766 -204 -204
+ admin 1 -204 32766
+ pat 100 -204 1
+ smith 101 -204 1
+ pat:friends -206 100 100
staff -207 -204 1
=head1 PRIVILEGE REQUIRED
B<pts groups> B<-na> <I<user or group name or id>>+ [-c <I<cell name>>]
[B<-no>] [B<-f>] [B<-h>]
-
+
B<pts g> B<-na> <I<user or group name or id>>+ [B<-c> <I<cell name>>]
[B<-no>] [B<-f>] [B<-h>]
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-force>] [B<-help>]
B<pts setf> B<-na> <I<user or group name or id>>+
- [B<-a> <I<set privacy flags>>]
- [B<-g> <I<set limit on group creation>>] [B<-c> <I<cell name>>]
+ [B<-a> <I<set privacy flags>>]
+ [B<-g> <I<set limit on group creation>>] [B<-c> <I<cell name>>]
[B<-no>] [B<-f>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
B<pts setmax> [B<-group> <I<group max>>] [B<-user> <I<user max>>]
- [B<-cell> <I<cell name>>] [B<-noauth>] [B<-force>] [B<-help>]
+ [B<-cell> <I<cell name>>] [B<-noauth>] [B<-force>] [B<-help>]
B<pts setm> [B<-g> I<group max>>] [B<-u> <I<user max>>]
[B<-c> <I<cell name>>] [B<-n>] [B<-f>] [B<-h>]
[B<-onlyclient>] [B<-onlyport> <I<show only port>>]
[B<-onlyhost> <I<show only host>>]
[B<-onlyauth> <I<show only auth level>>] [B<-version>]
- [B<-noconns>] [B<-peers>] [B<-help>]
+ [B<-noconns>] [B<-peers>] [B<-help>]
B<rxdebug> B<-s> <I<server machine>> [B<-po> <I<IP port>>] [B<-nod>]
- [B<-a>] [B<-r>] [B<-onlys>] [B<-onlyc>] [B<-onlyp> <I<show only port>>]
- [B<-onlyh> <I<show only host>>] [-onlya <I<show only auth level>>]
- [B<-v>] [B<-noc>] [B<-pe>] [B<-h>]
+ [B<-a>] [B<-r>] [B<-onlys>] [B<-onlyc>] [B<-onlyp> <I<show only port>>]
+ [B<-onlyh> <I<show only host>>] [-onlya <I<show only auth level>>]
+ [B<-v>] [B<-noc>] [B<-pe>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
B<scout> [B<initcmd>] B<-server> <I<servers to monitor>>+
- [B<-basename> <I<base server name>>]
+ [B<-basename> <I<base server name>>]
[B<-frequency> <I<poll frequency, in seconds>>] [B<-host>]
[B<-attention> <I<specify attention (highlighting) level>>+]
[B<-debug> <I<turn debugging output on to the named file>>]
[B<-help>]
-B<scout> [B<i>] B<-s> <I<servers to monitor>>+
- [B<-b> <I<base server name>>] [B<-f> <I<poll frequency, in seconds>>]
+B<scout> [B<i>] B<-s> <I<servers to monitor>>+
+ [B<-b> <I<base server name>>] [B<-f> <I<poll frequency, in seconds>>]
[B<-ho>] [B<-a> <I<specify attention (highlighting) level>>+]
[B<-d> <I<turn debugging output on to the named file>>] [B<-he>]
=head1 SYNOPSIS
-sys
+sys
=head1 DESCRIPTION
Tokens held by the Cache Manager:
--End of list--
-
+
The following example shows the output when the issuer is authenticated in
ABC Corporation cell, where he or she has AFS UID 1000.
I am sync site . . . (<#_sites> servers)
- I am not sync site
+ I am not sync site
For the synchronization site, the following message indicates that all
sites have the same version of the database, which implies that Ubik is
Otherwise, the output continues with the following messages.
- Last yes vote for <sync_IP_addr> was <last_vote> secs ago (sync site);
+ Last yes vote for <sync_IP_addr> was <last_vote> secs ago (sync site);
Last vote started <vote_start> secs ago (at <date/time>)
Local db version is <db_version>
Server on the machine C<afs1>, which is the synchronization site.
% udebug afs1 vlserver
- Host's addresses are: 192.12.107.33
+ Host's addresses are: 192.12.107.33
Host's 192.12.107.33 time is Wed Oct 27 09:49:50 1999
Local time is Wed Oct 27 09:49:52 1999 (time differential 2 secs)
- Last yes vote for 192.12.107.33 was 1 secs ago (sync site);
+ Last yes vote for 192.12.107.33 was 1 secs ago (sync site);
Last vote started 1 secs ago (at Wed Oct 27 09:49:51 1999)
Local db version is 940902602.674
I am sync site until 58 secs from now (at Wed Oct 27 09:50:50 1999) (3 servers)
last vote rcvd 2 secs ago (at Wed Oct 27 09:49:50 1999),
last beacon sent 1 secs ago (at Wed Oct 27 09:49:51 1999), last vote was yes
dbcurrent=1, up=1 beaconSince=1
-
+
Server( 192.12.107.34 ): (db 940902602.674)
last vote rcvd 2 secs ago (at Wed Oct 27 09:49:50 1999),
last beacon sent 1 secs ago (at Wed Oct 27 09:49:51 1999), last vote was yes
Host's 192.12.107.34 time is Wed Oct 27 09:54:15 1999
Local time is Wed Oct 27 09:50:08 1999 (time differential -247 secs)
****clock may be bad
- Last yes vote for 192.12.107.33 was 6 secs ago (sync site);
+ Last yes vote for 192.12.107.33 was 6 secs ago (sync site);
Last vote started 6 secs ago (at Wed Oct 27 09:50:02 1999)
Local db version is 940906574.25
I am not sync site
/vicepa = vicepa = a = 0
/vicepb = vicepb = b = 1
-After /vicepz (for which the index is 25) comes
+After /vicepz (for which the index is 25) comes
/vicepaa = vicepaa = aa = 26
/vicepab = vicepab = ab = 27
-and so on through
+and so on through
/vicepiv = vicepiv = iv = 255
B<vos addsite> B<-server> <I<machine name for new site>>
B<-partition> <I<partition name for new site>>
- B<-id> <I<volume name or ID>> [B<-cell> <I<cell name>>]
+ B<-id> <I<volume name or ID>> [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
B<vos ad> B<-s> <I<machine name for new site>>
B<vos backup> B<-id> <I<volume name or ID>> [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
-
+
B<vos backup> B<-i> <I<volume name or ID>> [B<-c><I<cell name>>]
[B<-n>] [B<-l>] [B<-v>] [B<-h>]
=head1 SYNOPSIS
-B<vos backupsys> [B<-prefix> <I<common prefix on volume(s)>>+]
- [B<-server> <I<machine name>>] [B<-partition> <I<partition name>>]
- [B<-exclude>] [B<-xprefix> <I<negative prefix on volume(s)>>+]
+B<vos backupsys> [B<-prefix> <I<common prefix on volume(s)>>+]
+ [B<-server> <I<machine name>>] [B<-partition> <I<partition name>>]
+ [B<-exclude>] [B<-xprefix> <I<negative prefix on volume(s)>>+]
[B<-dryrun>] [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>]
[B<-verbose>] [B<-help>]
B<vos changeaddr> B<-oldaddr> <I<original IP address>>
[B<-newaddr> <I<new IP address>>] [B<-remove>]
- [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>]
+ [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>]
[B<-verbose>] [B<-help>]
B<vos ch> B<-o> <I<original IP address>> [B<-ne> <I<new IP address>>]
=head1 SYNOPSIS
B<vos create> B<-server> <I<machine name>> B<-partition> <I<partition name>>
- B<-name> <I<volume name>> [B<-maxquota> <I<initial quota (KB)>>]
+ B<-name> <I<volume name>> [B<-maxquota> <I<initial quota (KB)>>]
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-verbose>]
[B<-help>]
=head1 SYNOPSIS
B<vos delentry> [B<-id> <I<volume name or ID>>+]
- [B<-prefix> <I<prefix of volume whose VLDB entry is to be deleted>>]
- [B<-server> <I<machine name>>] [B<-partition> <I<partition name>>]
+ [B<-prefix> <I<prefix of volume whose VLDB entry is to be deleted>>]
+ [B<-server> <I<machine name>>] [B<-partition> <I<partition name>>]
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-verbose>]
[B<-help>]
B<vos de> [B<-i> <I<volume name or ID>>+]
- [B<-pr> <I<prefix of volume whose VLDB entry is to be deleted>>]
+ [B<-pr> <I<prefix of volume whose VLDB entry is to be deleted>>]
[B<-s> <I<machine name>>] [B<-pa> <I<partition name>>]
[B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-v>] [B<-h>]
B<vos dump> B<-id> <I<volume name or ID>> [B<-time> <I<dump from time>>]
[B<-file> <I<dump file>>] [B<-server> <I<server>>]
- [B<-partition> <I<partition>>] [B<-cell> <I<cell name>>]
+ [B<-partition> <I<partition>>] [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
B<vos du> B<-i> <I<volume name or ID>> [B<-t> <I<dump from time>>]
B<vos e> B<-i> <I<volume name or ID>> [B<-e>] [B<-c> <I<cell name>>]
[B<-n>] [B<-l>] [B<-v>] [B<-h>]
-B<vos volinfo> B<-i> <I<volume name or ID>> [B<-e>] [-c <I<cell name>>]
+B<vos volinfo> B<-i> <I<volume name or ID>> [B<-e>] [-c <I<cell name>>]
[B<-n>] [B<-l>] [B<-v>] [B<-h>]
-
+
B<vos v> B<-i> <I<volume name or ID>> [B<-e>] [B<-c> <I<cell name>>]
[B<-n>] [B<-l>] [B<-v>] [B<-h>]
=item *
Basic information about the specified volume (displayed on a single
-line):
+line):
=over 4
5719 accesses in the past day (i.e., vnode references)
RWrite: 5360870981 ROnly: 536870982 Backup: 536870983
number of sites -> 3
- server fs1.abc.com partition /vicepa RO Site
- server fs3.abc.com partition /vicepa RO Site
- server fs2.abc.com partition /vicepb RW Site
- Volume is currently LOCKED
+ server fs1.abc.com partition /vicepa RO Site
+ server fs3.abc.com partition /vicepa RO Site
+ server fs2.abc.com partition /vicepb RW Site
+ Volume is currently LOCKED
The following example shows the output for the volume C<user.terry> using
the B<-extended> flag. The volume has no read-only replication sites.
command:
% vos help create
- vos create: create a new volume
- Usage: vos create -server <machine name> -partition <partition name>
- -name <volume name> [-cell <cell name>] [-noauth] [-localauth]
+ vos create: create a new volume
+ Usage: vos create -server <machine name> -partition <partition name>
+ -name <volume name> [-cell <cell name>] [-noauth] [-localauth]
[-verbose] [-help]
=head1 PRIVILEGE REQUIRED
The following command displays the VLDB server entries in the ABC
Corporation cell:
- % vos listaddrs
+ % vos listaddrs
sv5.abc.com
sv1.abc.com
sv2.abc.com afs2.abc.com
volume called C<usr>, which has two read-only replication sites:
% vos listvldb -name usr
- usr
+ usr
RWrite: 5360870981 ROnly: 536870982 Backup: 536870983
number of sites -> 3
- server fs1.abc.com partition /vicepa RO Site
- server fs3.abc.com partition /vicepa RO Site
- server fs2.abc.com partition /vicepb RW Site
+ server fs1.abc.com partition /vicepa RO Site
+ server fs3.abc.com partition /vicepa RO Site
+ server fs2.abc.com partition /vicepb RW Site
The following example shows entries for two of the volumes that reside on
the file server machine C<fs4.abc.com>. The first VLDB entry is currently
VLDB entries for server fs4.abc.com
. . . .
. . . .
- user.smith
+ user.smith
RWrite: 278541326 ROnly: 278541327 Backup: 278542328
number of sites -> 1
- server fs4.abc.com partition /vicepg RW Site
+ server fs4.abc.com partition /vicepg RW Site
Volume is currently LOCKED
user.terry
RWrite 354287190 ROnly 354287191 Backup 354287192
number of sites -> 1
- server fs4.abc.com partition /vicepc RW Site
+ server fs4.abc.com partition /vicepc RW Site
. . . .
. . . .
Total entries: 508
. . . . . .
user.pat 1969534536 RW 17518 K On-line
fs2.abc.com /vicepb
- RWrite 1969534536 ROnly 0 Backup 1969534538
+ RWrite 1969534536 ROnly 0 Backup 1969534538
MaxQuota 20000 K
Creation Mon Jun 12 09:02:25 1989
Last Update Thu May 20 17:39:34 1999
1573 accesses in the past day (i.e., vnode references)
user.pat.backup 1969534538 BK 17537 K On-line
fs2.abc.com /vicepb
- RWrite 1969534536 ROnly 0 Backup 1969534538
+ RWrite 1969534536 ROnly 0 Backup 1969534538
MaxQuota 20000 K
Creation Tue Jun 13 04:37:59 1989
Last Update Wed May 19 06:37:59 1999
B<vos move> B<-id> <I<volume name or ID>>
B<-fromserver> <I<machine name on source>>
- B<-frompartition> <I<partition name on source>>
- B<-toserver> <I<machine name on destination>>
- B<-topartition> <I<partition name on destination>>
+ B<-frompartition> <I<partition name on source>>
+ B<-toserver> <I<machine name on destination>>
+ B<-topartition> <I<partition name on destination>>
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-verbose>]
[B<-help>]
B<vos m -i> <I<volume name or ID>>
- B<-froms> <I<machine name on source>>
+ B<-froms> <I<machine name on source>>
B<-fromp> <I<partition name on source>>
- B<-tos> <I<machine name on destination>>
+ B<-tos> <I<machine name on destination>>
B<-top> <I<partition name on destination>>
[-c <I<cell name>>] [B<-n>] [B<-l>] [B<-v>] [B<-h>]
=head1 SYNOPSIS
-B<vos restore> B<-server> <I<machine name>> B<-partition> <I<partition name>>
- B<-name> <I<name of volume to be restored>> [B<-file> <I<dump file>>]
- [B<-id> <I<volume ID>>] [B<-overwrite> (abort | full | incremental)]
- [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [-verbose]
+B<vos restore> B<-server> <I<machine name>> B<-partition> <I<partition name>>
+ B<-name> <I<name of volume to be restored>> [B<-file> <I<dump file>>]
+ [B<-id> <I<volume ID>>] [B<-overwrite> (abort | full | incremental)]
+ [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [-verbose]
[B<-help>]
-B<vos res> B<-s> <I<machine name>> B<-p> <I<partition name>>
- B<-na> <I<name of volume to be restored>> [B<-f> <I<dump file>>]
- [B<-i> <I<volume ID>>] [B<-o> (a | f | i)] [B<-c> <I<cell name>>]
+B<vos res> B<-s> <I<machine name>> B<-p> <I<partition name>>
+ B<-na> <I<name of volume to be restored>> [B<-f> <I<dump file>>]
+ [B<-i> <I<volume ID>>] [B<-o> (a | f | i)] [B<-c> <I<cell name>>]
[B<-no>] [B<-l>] [B<-v>] [B<-h>]
=head1 DESCRIPTION
[B<-partition> <I<partition name>>] [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
-B<vos syncs> B<-s> <I<machine name>> [B<-p> <I<partition name>>]
+B<vos syncs> B<-s> <I<machine name>> [B<-p> <I<partition name>>]
[B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-v>] [B<-h>]
=head1 DESCRIPTION
[B<-partition> <I<partition name>>] [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
-B<vos unlockv> [B<-s> <I<machine name>>] [B<-p> <I<partition name>>]
+B<vos unlockv> [B<-s> <I<machine name>>] [B<-p> <I<partition name>>]
[B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-v>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
-B<vos zap> B<-server> <I<machine name>> B<-partition> <I<partition name>>
+B<vos zap> B<-server> <I<machine name>> B<-partition> <I<partition name>>
B<-id> <I<volume ID>> [B<-force>] [B<-backup>]
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-verbose>]
[B<-help>]
B<xstat_cm_test> [I<initcmd>]
B<-cmname> <I<cache manager name(s) to monitor>>+
- B<-collID> <I<collection(s) to fetch>>+ [B<-onceonly>]
- [B<-frequency> <I<poll frequency, in seconds>>]
+ B<-collID> <I<collection(s) to fetch>>+ [B<-onceonly>]
+ [B<-frequency> <I<poll frequency, in seconds>>]
[B<-period> <I<data collection time, in minutes>>] [B<-debug>]
[B<-help>]
B<xstat_cm_test> [I<i>] B<-cm> <I<cache manager name(s) to monitor>>+
B<-co> <I<collection(s) to fetch>>+ [B<-o>]
- [B<-f> <I<poll frequency, in seconds>>]
+ [B<-f> <I<poll frequency, in seconds>>]
[B<-p> <I<data collection time, in minutes>>] [B<-d>] [B<-h>]
=head1 DESCRIPTION
amount of data the command interpreter gathers about the Cache Manager.
Data is returned in a predefined data structure.
-There are three acceptable values:
+There are three acceptable values:
=over 4
amount of data the command interpreter gathers about the File Server.
Data is returned in a predefined data structure.
-There are three acceptable values:
+There are three acceptable values:
=over 4
=item *
-The I<entry type>, which is one of the following:
+The I<entry type>, which is one of the following:
=over 4
set tries = $3
set tapename = $4
set tapeid = $5
-
+
set exit_continue = 0
set exit_abort = 1
set exit_interactive = 2
-
+
#--------------------------------------------
-
+
if (${tries} > 1) then
echo "Too many tries"
exit ${exit_interactive}
endif
-
+
if (${operation} == "unmount") then
echo "UnMount: Will leave tape in drive"
exit ${exit_continue}
endif
-
+
if ((${operation} == "dump") |\
(${operation} == "appenddump") |\
(${operation} == "savedb")) then
-
+
stackerCmd_NextTape ${devicefile}
if (${status} != 0)exit${exit_interactive}
echo "Will continue"
exit ${exit_continue}
endif
-
+
if ((${operation} == "labeltape") |\
(${operation} == "readlabel")) then
echo "Will continue"
exit ${exit_continue}
endif
-
+
echo "Prompt for tape"
exit ${exit_interactive}
set exit_continue = 0
set exit_abort = 1
set exit_interactive = 2
-
+
#--------------------------------------------
-
+
if (${tries} > 1) then
echo "Too many tries"
exit ${exit_interactive}
endif
-
+
if (${operation} == "labeltape") then
echo "Won't label a tape/file"
exit ${exit_abort}
endif
-
+
if ((${operation} == "dump") |\
(${operation} == "appenddump") |\
(${operation} == "restore") |\
(${operation} == "savedb") |\
(${operation} == "restoredb")) then
-
+
/bin/rm -f ${devicefile}
/bin/ln -s /hsm/${tapename}_${tapeid} ${devicefile}
if (${status} != 0) exit ${exit_abort}
endif
-
+
exit ${exit_continue}
Like the example routine for a tape stacker, this routine uses the
The two types of statement share a common syntax:
- (%ifdef | %ifndef) <declaration>
+ (%ifdef | %ifndef) <declaration>
<action>+
- [%else [<declaration>]
+ [%else [<declaration>]
<alternate_action>+]
%endif <declaration>
/vicepa = vicepa = a = 0
/vicepb = vicepb = b = 1
-After F</vicepz> (for which the index is 25) comes
+After F</vicepz> (for which the index is 25) comes
/vicepaa = vicepaa = aa = 26
/vicepab = vicepab = ab = 27
-and so on through
+and so on through
/vicepiv = vicepiv = iv = 255
F<public> in a new user's home directory, designates the user as the
directory's owner, and grants him or her all ACL permissions.
- D $MTPT/public 0755 $UID $USER all
+ D $MTPT/public 0755 $UID $USER all
The following example C<E> instruction creates a file in the current
working directory called F<I<username>.etcp>. The contents are an entry
Corporation cell, copies a prototype F<.login> file into the user's home
directory.
- F $MTPT/.login 0644 $UID /afs/abc.com/common/uss/skel/.login
+ F $MTPT/.login 0644 $UID /afs/abc.com/common/uss/skel/.login
In the following example, the State University cell's administrators
have decided to distribute user home directories evenly into three
legibility; it must appear on a single line in the template file.
V user.$USER $SERVER.abc.com /vicepa 3000 \
- /afs/abc.com/usr/$USER $UID $USER all
+ /afs/abc.com/usr/$USER $UID $USER all
The following example C<X> instruction mounts the backup version of the
user's volume at the F<OldFiles> subdirectory.
/vicepa = vicepa = a = 0
/vicepb = vicepb = b = 1
-After F</vicepz> (for which the index is 25) comes
+After F</vicepz> (for which the index is 25) comes
/vicepaa = vicepaa = aa = 26
/vicepab = vicepab = ab = 27
-and so on through
+and so on through
/vicepiv = vicepiv = iv = 255
instruction in a template file (which must appear on a single line in the
template file).
- add smith:John Smith:::fs1:a:::::marketing
+ add smith:John Smith:::fs1:a:::::marketing
add jones:Pat Jones:::fs3:c:::::finance
V user.$USER $SERVER.abc.com /vicep$PART 2000 \
/afs/abc.com/usr/$3/$USER $UID $USER all
=head1 SYNOPSIS
-B<afsd> [B<-blocks> <I<1024 byte blocks in cache>>]
+B<afsd> [B<-blocks> <I<1024 byte blocks in cache>>]
[B<-files> <I<files in cache>>]
[B<-rootvol> <I<name of AFS root volume>>]
[B<-stat> <I<number of stat entries>>]
- [B<-memcache>] [B<-cachedir> <I<cache directory>>]
+ [B<-memcache>] [B<-cachedir> <I<cache directory>>]
[B<-mountdir> <I<mount location>>]
- [B<-daemons> <I<number of daemons to use>>]
+ [B<-daemons> <I<number of daemons to use>>]
[B<-nosettime>] [B<-verbose>] [B<-rmtsys>] [B<-debug>]
[B<-chunksize> <I<log(2) of chunk size>>]
[B<-dcache> <I<number of dcache entries>>]
- [B<-volumes> <I<number of volume entries>>]
+ [B<-volumes> <I<number of volume entries>>]
[B<-biods> <I<number of bkg I/O daemons (aix vm)>>]
[B<-prealloc> <I<number of 'small' preallocated blocks>>]
[B<-confdir> <I<configuration directory>>]
- [B<-logfile> <I<Place to keep the CM log>>]
+ [B<-logfile> <I<Place to keep the CM log>>]
[B<-waitclose>] [B<-shutdown>] [B<-enable_peer_stats>]
[B<-enable_process_stats>] [B<-help>]
representation is in February 2038. The command interpreter automatically
reduces later dates to the maximum value.
-Relative expiration dates have the following format:
+Relative expiration dates have the following format:
[in] [<years>y] [<months>m] [<days>d]
=head1 SYNOPSIS
B<backup addvolentry> B<-name> <I<volume set name>>
- B<-server> <I<machine name>> B<-partition> <I<partition name>>
- B<-volumes> <I<volume name (regular expression)>>
+ B<-server> <I<machine name>> B<-partition> <I<partition name>>
+ B<-volumes> <I<volume name (regular expression)>>
[B<-localauth>] [B<-cell> <I<cell name>>] [B<-help>]
B<backup addvole> B<-n> <I<volume set name>> B<-s> <I<machine name>>
=head1 SYNOPSIS
-B<backup apropos> B<-topic> <I<help string>> [B<-help>]
+B<backup apropos> B<-topic> <I<help string>> [B<-help>]
B<backup ap> B<-t> <I<help string>> [B<-h>]
=head1 SYNOPSIS
-B<backup diskrestore> B<-server> <I<machine to restore>>
+B<backup diskrestore> B<-server> <I<machine to restore>>
B<-partition> <I<partition to restore>>
- [B<-portoffset> <I<TC port offset>>+]
+ [B<-portoffset> <I<TC port offset>>+]
[B<-newserver> <I<destination machine>>]
[B<-newpartition> <I<destination partition>>]
[B<-extension> <I<new volume name extension>>]
themselves scheduled; the specified date and time must be later than the
date and time at which the Backup System reads the file.
- dump user /sunday1/wednesday -port 1
+ dump user /sunday1/wednesday -port 1
dump sun4x_56 /sunday1/friday -port 2 -at 04/08/1999
dump sun4x_55 /sunday1/friday -port 2 -at 04/08/1999 02:00 -append
=item dump name
-The dump name in the form
+The dump name in the form
<volume_set_name>.<dump_level_name> (<initial_dump_ID>)
% backup help dump
backup dump: start dump
- Usage: backup dump -volumeset <volume set name> -dump <dump level name>
- [-portoffset <TC port offset>] [-at <Date/time to start dump>+]
+ Usage: backup dump -volumeset <volume set name> -dump <dump level name>
+ [-portoffset <TC port offset>] [-at <Date/time to start dump>+]
[-append] [-n] [-file <load file>] [-help]
=head1 PRIVILEGE REQUIRED
% backup
backup> help dump
- dump: start dump
- Usage: dump [-volumeset <volume set name>] [-dump <dump level name>]
+ dump: start dump
+ Usage: dump [-volumeset <volume set name>] [-dump <dump level name>]
[-portoffset <TC port offset>] [-at <Date/time to start dump>+]
- [-append ] [-n ] [-file <load file>] [-help ]
+ [-append ] [-n ] [-file <load file>] [-help ]
=head1 PRIVILEGE REQUIRED
If a dump level has an associated expiration date, it appears along with
the level name. Absolute expiration dates appear in the format
- <dump_level> expires at <day month date time year>
+ <dump_level> expires at <day month date time year>
and relative expiration dates in the format
/thursday expires in 13d
/sunday1 expires in 27d
/monday1 expires in 13d
- /tuesday1 expires in 13d
+ /tuesday1 expires in 13d
/wednesday1 expires in 13d
/thursday1 expires in 13d
/friday1 expires in 13d
/friday2 expires in 13d
/sunday3 expires in 27d
/monday1 expires in 13d
- /tuesday1 expires in 13d
+ /tuesday1 expires in 13d
/wednesday1 expires in 13d
/thursday1 expires in 13d
/friday1 expires in 13d
previous dumps of the database (created with the B<backup savedb> command)
are never deleted; use the B<backup deletedump> command to remove them.
-Provide one of two values:
+Provide one of two values:
=over 4
representation is in February 2038. The command interpreter automatically
reduces later dates to the maximum value.
-Relative expiration dates have the following format:
+Relative expiration dates have the following format:
[in] [<years>y] [<months>m] [<days>d]
% backup volinfo -volume user.smith.backup
DumpID lvl parentID creation date clone date tape name
924600000 1 924427600 04/20/1999 05:20 04/20/1999 05:01 user_incr_2 (924514392)
- 924514392 1 924427600 04/19/1999 05:33 04/19/1999 05:08 user_incr_2
- 924427600 0 0 04/18/1999 05:26 04/18/1999 04:58 user_full_6
+ 924514392 1 924427600 04/19/1999 05:33 04/19/1999 05:08 user_incr_2
+ 924427600 0 0 04/18/1999 05:26 04/18/1999 04:58 user_full_6
. . . . . . . .
. . . . . . . .
B<backup volrestore> B<-server> <I<destination machine>>
B<-partition> <I<destination partition>>
- B<-volume> <I<volume(s) to restore>>+
+ B<-volume> <I<volume(s) to restore>>+
[B<-extension> <I<new volume name extension>>]
[B<-date> <I<date from which to restore>>+]
[B<-portoffset> <I<TC port offsets>>+] [B<-n>]
only for legibility reasons.)
% backup volrestore -server fs4.abc.com -partition b \
- -volume user.smith user.terry \
+ -volume user.smith user.terry \
-extension .rst -date 1/31/1998 17:00
The following command restores the volume user.pat to partition F</vicepb>
=head1 SYNOPSIS
B<backup volsetrestore> [B<-name> <I<volume set name>>]
- [B<-file> <I<file name>>] [B<-portoffset> <I<TC port offset>>+]
+ [B<-file> <I<file name>>] [B<-portoffset> <I<TC port offset>>+]
[B<-extension> <I<new volume name extension>>] [B<-n>]
[B<-localauth>] [B<-cell> <I<cell name>>] [B<-help>]
<machine> <partition> <volume> [<comments> ...]
-where
+where
=over 4
% bos getlog -server fs3.abc.com -file FileLog
Fetching log file 'FileLog'...
Sun Nov 8 04:00:34 1998 File server starting
- Sun Nov 8 04:00:39 1998 Partition /vicepa: attached 21 volumes;
+ Sun Nov 8 04:00:39 1998 Partition /vicepa: attached 21 volumes;
0 volumes not attached
- Sun Nov 8 04:00:40 1998 File Server started Sun Nov 8 04:00:40
+ Sun Nov 8 04:00:40 1998 File Server started Sun Nov 8 04:00:40
1998
- Mon Nov 9 21:45:06 1998 CB: RCallBack (zero fid probe in host.c)
+ Mon Nov 9 21:45:06 1998 CB: RCallBack (zero fid probe in host.c)
failed for host 28cf37c0.22811
=head1 PRIVILEGE REQUIRED
=head1 SYNOPSIS
-B<bos getrestart> B<-server> <I<machine name>> [B<-cell> <I<cell name>>]
+B<bos getrestart> B<-server> <I<machine name>> [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-help>]
B<bos getr> B<-s> <I<machine name>> [B<-c> <I<cell name>>] [B<-n>]
command:
% bos help status
- bos status: show server instance status
+ bos status: show server instance status
Usage: bos status -server <machine name> [-instance <server
- process name>+] [-long] [-cell <cell name>] [-noauth]
+ process name>+] [-long] [-cell <cell name>] [-noauth]
[-localauth] [-help]
=head1 PRIVILEGE REQUIRED
=head1 SYNOPSIS
B<bos install> B<-server> <I<machine name>> B<-file> <I<files to install>>+
- [B<-dir> <I<destination dir>>] [B<-cell> <I<cell name>>]
+ [B<-dir> <I<destination dir>>] [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-help>]
B<bos i> B<-s> <I<machine name>> B<-f> <I<files to install>>+
=head1 SYNOPSIS
-B<bos listhosts> B<-server> <I<machine name>> [B<-cell> <I<cell name>>]
+B<bos listhosts> B<-server> <I<machine name>> [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-help>]
B<bos listh> B<-s> <I<machine name>> [B<-c> <I<cell name>>] [B<-n>]
[B<-l>] [-h]
-B<bos getcell> B<-server> <I<machine name>> [B<-cell> <I<cell name>>]
+B<bos getcell> B<-server> <I<machine name>> [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-help>]
-
+
B<bos getc> B<-s> <I<machine name>> [B<-c> <I<cell name>>] [B<-n>]
[B<-l>] [-h]
=head1 SYNOPSIS
-B<bos listusers> B<-server> <I<machine name>> [B<-cell> <I<cell name>>]
+B<bos listusers> B<-server> <I<machine name>> [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-help>]
B<bos listu> B<-s> <I<machine name>> [B<-c> <I<cell name>>] [B<-n>]
[B<-all>] [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>]
[B<-help>]
-B<bos p> B<-s> <I<machine name>> [B<-b>] [B<-o>] [B<-co>] [B<-a>]
+B<bos p> B<-s> <I<machine name>> [B<-b>] [B<-o>] [B<-co>] [B<-a>]
[B<-ce> <I<cell name>>] [B<-n>] [B<-l>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
-B<bos removehost> B<-server> <I<machine name>> B<-host> <I<host name>>+
+B<bos removehost> B<-server> <I<machine name>> B<-host> <I<host name>>+
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
B<bos removeh> B<-s> <I<machine name>> B<-ho> <I<host name>>+
B<-kvno> <I<key version number>>+ [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-help>]
-B<bos removek> B<-s> <I<machine name>> B<-k> <I<key version number>>+
+B<bos removek> B<-s> <I<machine name>> B<-k> <I<key version number>>+
[B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
-B<bos removeuser> B<-server> <I<machine name>> B<-user> <I<user names>>+
+B<bos removeuser> B<-server> <I<machine name>> B<-user> <I<user names>>+
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
B<bos removeu> B<-s> <I<machine name>> B<-u> <I<user names>>+
[B<-partition> <I<salvage partition>>]
[B<-volume> <I<salvage volume number or volume name>>]
[B<-file> <I<salvage log output file>>] [B<-all>] [B<-showlog>]
- [B<-parallel> <I<# of max parallel partition salvaging>>]
- [B<-tmpdir> <I<directory to place tmp files>>]
+ [B<-parallel> <I<# of max parallel partition salvaging>>]
+ [B<-tmpdir> <I<directory to place tmp files>>]
[B<-orphans> (ignore | remove | attach)] [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-help>]
B<bos sa> B<-se> <I<machine name>> [B<-part> <I<salvage partition>>]
- [B<-v> <I<salvage volume number or volume name>>]
- [B<-f> <I<salvage log output file>>] [B<-a>] [B<-sh>]
- [<-para> <I<# of max parallel partition salvaging>>]
- [B<-t> <I<directory to place tmp files>>]
+ [B<-v> <I<salvage volume number or volume name>>]
+ [B<-f> <I<salvage log output file>>] [B<-a>] [B<-sh>]
+ [<-para> <I<# of max parallel partition salvaging>>]
+ [B<-t> <I<directory to place tmp files>>]
[B<-o> (ignore | remove | attach)] [B<-c> <I<cell name>>] [B<-n>]
[B<-l>] [B<-h>]
/vicepa = vicepa = a = 0
/vicepb = vicepb = b = 1
-After F</vicepz> (for which the index is 25) comes
+After F</vicepz> (for which the index is 25) comes
/vicepaa = vicepaa = aa = 26
/vicepab = vicepab = ab = 27
-and so on through
+and so on through
/vicepiv = vicepiv = iv = 255
=head1 SYNOPSIS
-B<bos setcellname> B<-server> <I<machine name>> B<-name> <I<cell name>>
+B<bos setcellname> B<-server> <I<machine name>> B<-name> <I<cell name>>
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
B<bos setc> B<-s> <I<machine name>> B<-n> <I<cell name>>
defined as daily (specifies only a time). However, it is acceptable to
define a daily general restart or weekly binary restart.
-There are four acceptable values for either type of restart setting:
+There are four acceptable values for either type of restart setting:
=over 4
B<-instance> <I<server process name>>+ [B<-cell> <I<cell name>>]
[B<-noauth>] [B<-localauth>] [B<-help>]
-B<bos start> B<-s> <I<machine name>> B<-i> <I<server process name>>+
+B<bos start> B<-s> <I<machine name>> B<-i> <I<server process name>>+
[B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-h>]
=head1 DESCRIPTION
B<bos startup> B<-server> <I<machine name>> [B<-instance> <I<instances>>+]
[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
-B<bos startu> B<-s> <I<machine name>> [B<-i> <I<instances>>+]
+B<bos startu> B<-s> <I<machine name>> [B<-i> <I<instances>>+]
[B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
-B<bos status -server> <I<machine name>> [-instance <I<server process name>>+]
-[B<-long>] [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
+B<bos status -server> <I<machine name>> [-instance <I<server process name>>+]
+[B<-long>] [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
-B<bos stat -s> <I<machine name>> [-i <I<server process name>>+]
-[B<-lon>] [B<-c> <I<cell name>>] [B<-n>] [B<-loc>] [B<-h>]
+B<bos stat -s> <I<machine name>> [-i <I<server process name>>+]
+[B<-lon>] [B<-c> <I<cell name>>] [B<-n>] [B<-loc>] [B<-h>]
=head1 DESCRIPTION
The bos status command reports the status of processes on the
-server machine named by the B<-server> argument, either
+server machine named by the B<-server> argument, either
=over 4
=back
-The entry for a cron process includes an C<Auxiliary
+The entry for a cron process includes an C<Auxiliary
status> that reports when the command will next execute.
If the -long flag is used, each entry includes the following
Instance fs, (type is fs), currently running normally.
Auxiliary status is: file server running.
Process last started at Wed Jan 7 5:34:49 1998 (3 proc starts)
- Last exit at Wed Jan 7 5:34:49 1998
- Last error exit at Wed Jan 7 5:34:49 1998, due to shutdown
+ Last exit at Wed Jan 7 5:34:49 1998
+ Last error exit at Wed Jan 7 5:34:49 1998, due to shutdown
request
Command 1 is '/usr/afs/bin/fileserver'
Command 2 is '/usr/afs/bin/volserver'
=head1 SYNOPSIS
-B<buserver> [B<-database> <I<database directory>>]
+B<buserver> [B<-database> <I<database directory>>]
[B<-cellservdb> <I<cell configuration directory>>] [B<-resetdb>]
[B<-noauth>] [B<-smallht>] [-servers <I<list of ubik database servers>>+]
[B<-enable_peer_stats>] [-enable_process_stats] [B<-help>]
=head1 SYNOPSIS
-B<butc> [B<-port> <I<port offset>>] [B<-debuglevel> (0 | 1 | 2)]
+B<butc> [B<-port> <I<port offset>>] [B<-debuglevel> (0 | 1 | 2)]
[B<-cell> <I<cell name>>] [B<-noautoquery>] [B<-localauth>] [B<-help>]
B<butc> [B<-p> <I<port offset>>] [B<-d> (0 | 1 | 2)]
=head1 SYNOPSIS
B<fileserver> [B<-d> <I<debug level>>] [B<-p> <I<number of processes>>]
- [B<-spare> <I<number of spare blocks>>]
+ [B<-spare> <I<number of spare blocks>>]
[B<-pctspare> <I<percentage spare>>] [B<-b> <I<buffers>>]
[B<-l> <I<large vnodes>>] [B<-s> <I<small nodes>>]
[B<-vc> <I<volume cachesize>>] [B<-w> <I<call back wait interval>>]
[B<-rxdbg>] [B<-rxdbge>] [B<-m> <I<min percentage spare in partition>>]
[B<-lock>] [B<-L>] [B<-S>] [B<-k> <I<stack size>>]
[B<-realm> <I<Kerberos realm name>>]
- [B<-udpsize> <I<size of socket buffer in bytes>>]
+ [B<-udpsize> <I<size of socket buffer in bytes>>]
[B<-enable_peer_stats>] [B<-enable_process_stats>] [B<-help>]
=head1 DESCRIPTION
=head1 SYNOPSIS
B<fstrace clear> [B<-set> <I<set name>>+] [B<-log> <I<log name>>+]
- [B<-help>]
+ [B<-help>]
B<fstrace c> [B<-s> <I<set name>>+] [B<-l> <I<log name>>+] [B<-h>]
Date: Tue Apr 7 10:54:57 1998
Found 1 logs.
time 32.965783, pid 0: Tue Apr 7 10:45:52 1998
- time 32.965783, pid 33657: Close 0x5c39ed8 flags 0x20
- time 32.965897, pid 33657: Gn_close vp 0x5c39ed8 flags 0x20 (returns 0x0)
+ time 32.965783, pid 33657: Close 0x5c39ed8 flags 0x20
+ time 32.965897, pid 33657: Gn_close vp 0x5c39ed8 flags 0x20 (returns 0x0)
time 35.159854, pid 10891: Breaking callback for 5bd95e4 states 1024 (volume 0)
time 35.407081, pid 10891: Breaking callback for 5c0fadc states 1024 (volume 0)
.
.
.
time 71.440456, pid 33658: Lookup adp 0x5bbdcf0 name g3oCKs \
- fid (756 4fb7e:588d240.2ff978a8.6)
- time 71.440569, pid 33658: Returning code 2 from 19
- time 71.440619, pid 33658: Gn_lookup vp 0x5bbdcf0 name g3oCKs (returns 0x2)
- time 71.464989, pid 38267: Gn_open vp 0x5bbd000 flags 0x0 (returns 0x0)
+ fid (756 4fb7e:588d240.2ff978a8.6)
+ time 71.440569, pid 33658: Returning code 2 from 19
+ time 71.440619, pid 33658: Gn_lookup vp 0x5bbdcf0 name g3oCKs (returns 0x2)
+ time 71.464989, pid 38267: Gn_open vp 0x5bbd000 flags 0x0 (returns 0x0)
AFS Trace Dump - Completed
The following command dumps the trace log associated with the cm event set
setset> command:
% fstrace help -topic setset
- fstrace setset: set state of event sets
- Usage: fstrace setset [-set <set_name>+] [-active] [-inactive]
- [-dormant] [-help]
+ fstrace setset: set state of event sets
+ Usage: fstrace setset [-set <set_name>+] [-active] [-inactive]
+ [-dormant] [-help]
=head1 PRIVILEGE REQUIRED
[B<-long>] [B<-help>]
B<fstrace lsl> [B<-s> <I<set name>>+] [B<-log> <I<log name>>] [B<-lon>]
- [B<-h>]
+ [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
B<fstrace setset> [B<-set> <I<set name>>+] [B<-active>] [B<-inactive>]
- [B<-dormant>] [B<-help>]
+ [B<-dormant>] [B<-help>]
B<fs set> [B<-s> <I<set name>>+] [B<-a>] [B<-i>] [B<-d>] [B<-h>]
=head1 SYNOPSIS
B<kas create> B<-name> <I<name of user>>
- [B<-initial_password> <I<initial password>>]
- [B<-admin_username> <I<admin principal to use for authentication>>]
- [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
- [B<-servers> <I<explicit list of authentication servers>>+]
+ [B<-initial_password> <I<initial password>>]
+ [B<-admin_username> <I<admin principal to use for authentication>>]
+ [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
+ [B<-servers> <I<explicit list of authentication servers>>+]
[B<-noauth>] [B<-help>]
-B<kas c> B<-na> <I<name of user>> [B<-i> <I<initial password>>]
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+B<kas c> B<-na> <I<name of user>> [B<-i> <I<initial password>>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
=head1 DESCRIPTION
B<-password_for_admin> arguments.
% kas create smith
- Password for admin:
+ Password for admin:
initial_password:
Verifying, please re-enter initial_password:
=head1 SYNOPSIS
-B<kas delete> B<-name> <I<name of user>>
- [B<-admin_username> <I<admin principal to use for authentication>>]
+B<kas delete> B<-name> <I<name of user>>
+ [B<-admin_username> <I<admin principal to use for authentication>>]
[B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
[B<-servers> <I<explicit list of authentication servers>>+]
[B<-noauth>] [B<-help>]
B<kas d> B<-na> <I<name of user>>
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
-
+
B<kas rm> B<-na> <I<name of user>>
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
-B<kas examine> B<-name> <I<name of user>> [B<-showkey>]
- [B<-admin_username> <I<admin principal to use for authentication>>]
+B<kas examine> B<-name> <I<name of user>> [B<-showkey>]
+ [B<-admin_username> <I<admin principal to use for authentication>>]
[B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
- [B<-servers> <I<explicit list of authentication servers>>+]
- [B<-noauth>] [B<-help>]
+ [B<-servers> <I<explicit list of authentication servers>>+]
+ [B<-noauth>] [B<-help>]
B<kas e> B<-na> <I<name of user>> [B<-sh>]
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-se> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
=head1 DESCRIPTION
% kas examine -name afs -showkey
Password for admin: I<admin_password>
User data for afs
- key (12): \357\253\304\352\234\236\253\352, last cpw: no date
+ key (12): \357\253\304\352\234\236\253\352, last cpw: no date
entry never expires. Max ticket lifetime 100.00 hours.
last mod on Thu Mar 25 14:53:29 1999 by admin
permit password reuse
setpassword> command:
% kas help setpassword
- kas setpassword: set a user's password
- aliases: sp
- Usage: kas setpassword -name <name of user>
- [-new_password <new password>] [-kvno <key version number>]
- [-admin_username <admin principal to use for authentication>]
- [-password_for_admin <password>] [-cell <cell name>]
- [-servers <explicit list of authentication servers>+] [-help]
+ kas setpassword: set a user's password
+ aliases: sp
+ Usage: kas setpassword -name <name of user>
+ [-new_password <new password>] [-kvno <key version number>]
+ [-admin_username <admin principal to use for authentication>]
+ [-password_for_admin <password>] [-cell <cell name>]
+ [-servers <explicit list of authentication servers>+] [-help]
=head1 PRIVILEGE REQUIRED
=head1 SYNOPSIS
B<kas interactive>
- [B<-admin_username> <I<admin principal to use for authentication>>]
- [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
- [B<-servers> <I<explicit list of authentication servers>>+]
+ [B<-admin_username> <I<admin principal to use for authentication>>]
+ [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
+ [B<-servers> <I<explicit list of authentication servers>>+]
[B<-noauth>] [B<-help>]
-B<kas i> [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+B<kas i> [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-n>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
B<kas list> [B<-long>] [B<-showadmin>] [B<-showkey>]
- [B<-admin_username> <I<admin principal to use for authentication>>]
- [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
+ [B<-admin_username> <I<admin principal to use for authentication>>]
+ [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
[B<-servers> <I<explicit list of authentication servers>>+]
[B<-noauth>] [B<-help>]
B<kas ls> [B<-l>] [B<-showa>] [B<-showk>]
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
- [B<-se> <I<explicit list of authentication servers>>+] [B<-n>] [B<-h>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+ [B<-se> <I<explicit list of authentication servers>>+] [B<-n>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
B<kas setfields> B<-name> <I<name of user>>
- [B<-flags> <I<hex flag value or flag name expression>>]
- [B<-expiration> <I<date of account expiration>>]
- [B<-lifetime> <I<maximum ticket lifetime>>]
+ [B<-flags> <I<hex flag value or flag name expression>>]
+ [B<-expiration> <I<date of account expiration>>]
+ [B<-lifetime> <I<maximum ticket lifetime>>]
[B<-pwexpires> <I<number days password is valid ([0..254])>>]
[B<-reuse> <I<permit password reuse (yes/no)>>]
[B<-attempts> <I<maximum successive failed login tries ([0..254])>>]
[B<-locktime> <I<failure penalty [hh:mm or minutes]>>]
- [B<-admin_username> <I<admin principal to use for authentication>>]
+ [B<-admin_username> <I<admin principal to use for authentication>>]
[B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
[B<-servers> <I<explicit list of authentication servers>>+]
[B<-noauth>] [B<-help>]
[B<-r> <I<permit password reuse (yes/no)>>]
[B<-at> <I<maximum successive failed login tries ([0..254])>>]
[B<-lo> <I<failure penalty [hh:mm or minutes]>>]
- [B<-ad> <I<admin principal to use for authentication>>]
+ [B<-ad> <I<admin principal to use for authentication>>]
[B<-pa> <I<admin password>>] [B<-c> <I<cell name>>]
- [B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
-
+ [B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
+
B<kas sf> B<-na> <I<name of user>>
[B<-f> <I<hex flag value or flag name expression>>]
[B<-e> <I<date of account expiration>>]
[B<-r> <I<permit password reuse (yes/no)>>]
[B<-at> <I<maximum successive failed login tries ([0..254])>>]
[B<-lo> <I<failure penalty [hh:mm or minutes]>>]
- [B<-ad> <I<admin principal to use for authentication>>]
+ [B<-ad> <I<admin principal to use for authentication>>]
[B<-pa> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
B<kas setpassword> B<-name> <I<name of user>>
[B<-new_password> <I<new password>>] [B<-kvno> <I<key version number>>]
- [B<-admin_username> <I<admin principal to use for authentication>>]
- [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
+ [B<-admin_username> <I<admin principal to use for authentication>>]
+ [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
[B<-servers> <I<explicit list of authentication servers>>+]
[B<-noauth>] [B<-help>]
-B<kas setpasswd> B<-na> <I<name of user>> [B<-ne> <I<new password>>]
+B<kas setpasswd> B<-na> <I<name of user>> [B<-ne> <I<new password>>]
[B<-k> <I<key version number>>]
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
-
+
B<kas setp> B<-na> <I<name of user>> [B<-ne> <I<new password>>]
[B<-k> <I<key version number>>]
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
-
+
B<kas sp> B<-na> <I<name of user>> [B<-ne> <I<new password>>]
[B<-k> <I<key version number>>]
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
=head1 DESCRIPTION
command. The following error message appears if a user attempts to change
a password before the minimum time has passed:
- Password was not changed because you changed it too
+ Password was not changed because you changed it too
recently; see your systems administrator
=back
B<kas statistics>
[B<-admin_username> <I<admin principal to use for authentication>>]
- [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
+ [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
[B<-servers> <I<explicit list of authentication servers>>+]
[B<-noauth>] [B<-help>]
-B<kas sta> [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+B<kas sta> [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-n>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
-B<kas unlock> B<-name> <I<authentication ID>>
- [B<-admin_username> <I<admin principal to use for authentication>>]
- [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
+B<kas unlock> B<-name> <I<authentication ID>>
+ [B<-admin_username> <I<admin principal to use for authentication>>]
+ [B<-password_for_admin> <I<admin password>>] [B<-cell> <I<cell name>>]
[B<-servers> <I<explicit list of authentication servers>>+]
[B<-noauth>] [B<-help>]
B<kas u> B<-na> <I<authentication ID>>
- [B<-a> <I<admin principal to use for authentication>>]
- [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
+ [B<-a> <I<admin principal to use for authentication>>]
+ [B<-p> <I<admin password>>] [B<-c> <I<cell name>>]
[B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [B<-h>]
=head1 DESCRIPTION
=head1 DESCRIPTION
-B<kaserver> [B<-noAuth>] [B<-fastKeys>] [B<-database> <I<dbpath>>]
- [B<-localfiles> <I<lclpath>>] [B<-minhours> <I<n>>]
+B<kaserver> [B<-noAuth>] [B<-fastKeys>] [B<-database> <I<dbpath>>]
+ [B<-localfiles> <I<lclpath>>] [B<-minhours> <I<n>>]
[B<-servers> <I<serverlist>>] [B<-enable_peer_stats>]
[B<-enable_process_stats>] [B<-help>]
=head1 SYNOPSIS
-B<kdb> [B<-dbmfile> <I<dbmfile to use (default /usr/afs/logs/AuthLog)>>]
+B<kdb> [B<-dbmfile> <I<dbmfile to use (default /usr/afs/logs/AuthLog)>>]
[B<-key> <I<extract entries that match specified key>>] [B<-help>]
=head1 DESCRIPTION
}
return 0;
}
-
+
=head1 SEE ALSO
=head1 SYNOPSIS
-B<salvager> [I<initcmd>] [B<-partition> <I<name of partition to salvage>>]
+B<salvager> [I<initcmd>] [B<-partition> <I<name of partition to salvage>>]
[B<-volumeid> <I<volume id to salvage>>] [B<-debug>] [B<-nowrite>]
[B<-inodes>] [B<-force>] [B<-oktozap>] [B<-rootinodes>]
[B<-salvagedirs>] [B<-blockreads>]
[B<-parallel> <I<# of max parallel partition salvaging>>]
- [B<-tmpdir> <I<name of dir to place tmp files>>]
+ [B<-tmpdir> <I<name of dir to place tmp files>>]
[B<-showlog>] [B<-showsuid>] [B<-showmounts>]
[B<-orphans> (ignore | remove | attach)] [B<-help>]
=head1 SYNOPSIS
B<uss add> B<-user> <I<login name>> [B<-realname> <I<full name in quotes>>]
- [B<-pass> <I<initial password>>]
+ [B<-pass> <I<initial password>>]
[B<-pwexpires> <I<< password expires in [0..254] days (0 => never) >>>]
- [B<-server> <I<file server for home volume>>]
- [B<-partition> <I<file server's disk partition for home volume>>]
+ [B<-server> <I<file server for home volume>>]
+ [B<-partition> <I<file server's disk partition for home volume>>]
[B<-mount> <I<home directory mount point>>]
[B<-uid> <I<uid to assign the user>>]
- [B<-template> <I<pathname of template file>>]
- [B<-verbose>] [B<-var> <I<auxiliary argument pairs (Num val)>>+]
+ [B<-template> <I<pathname of template file>>]
+ [B<-verbose>] [B<-var> <I<auxiliary argument pairs (Num val)>>+]
[B<-cell> <I<cell name>>] [B<-admin> <I<administrator to authenticate>>]
[B<-dryrun>] [B<-skipauth>] [B<-overwrite>] [B<-help>]
-B<uss ad> B<-us> <I<login name>> [B<-r> <I<full name in quotes>>]
+B<uss ad> B<-us> <I<login name>> [B<-r> <I<full name in quotes>>]
[B<-pas> <I<initial password>>]
- [B<-pw> <I<< password expires in [0..254] days (0 => never) >>>]
- [B<-se> <I<FileServer for home volume>>]
- [B<-par> <I<FileServer's disk partition for home volume>>]
+ [B<-pw> <I<< password expires in [0..254] days (0 => never) >>>]
+ [B<-se> <I<FileServer for home volume>>]
+ [B<-par> <I<FileServer's disk partition for home volume>>]
[B<-m> <I<home directory mount point>>]
[B<-ui> <I<uid to assign the user>>]
[B<-t> <I<pathname of template file>>] [B<-ve>]
/vicepa = vicepa = a = 0
/vicepb = vicepb = b = 1
-After F</vicepz> (for which the index is 25) comes
+After F</vicepz> (for which the index is 25) comes
/vicepaa = vicepaa = aa = 26
/vicepab = vicepab = ab = 27
-and so on through
+and so on through
/vicepiv = vicepiv = iv = 255
[B<-cell> <I<cell name>>]
[B<-admin> <I<administrator to authenticate>>] [B<-dryrun>]
[B<-skipauth>] [B<-overwrite>]
- [B<-pwexpires> <I<password expires in [0..254] days (0 => never)>>]
+ [B<-pwexpires> <I<password expires in [0..254] days (0 => never)>>]
[B<-pipe>] [B<-help>]
B<uss b> B<-f> <I<bulk input file>> [B<-t> <I<pathname of template file>>]
[B<-v>] [B<-c> <I<cell name>>]
[B<-a> <I<administrator to authenticate>>] [B<-d>] [B<-s>]
- [B<-o>] [B<-pw> <I<password expires in [0..254] days (0 => never)>>]
+ [B<-o>] [B<-pw> <I<password expires in [0..254] days (0 => never)>>]
[B<-pi>] [B<-h>]
=head1 DESCRIPTION
=head1 SYNOPSIS
B<uss delete> B<-user> <I<login name>>
- [B<-mountpoint> <I<mountpoint for user's volume>>]
- [B<-savevolume>] [B<-verbose>] [B<-cell> <I<cell name>>]
+ [B<-mountpoint> <I<mountpoint for user's volume>>]
+ [B<-savevolume>] [B<-verbose>] [B<-cell> <I<cell name>>]
[B<-admin> <I<administrator to authenticate>>] [B<-dryrun>]
[B<-skipauth>] [B<-help>]
% uss help bulk
uss bulk: bulk input mode
- Usage: uss bulk -file <bulk input file> [-template <pathname
- of template file>] [-verbose] [-cell <cell name>] [-admin
- <administrator to authenticate>] [-dryrun] [-skipauth] [-overwrite]
- [-pwexpires <password expires in [0..254] days (0 => never)>] [-pipe]
+ Usage: uss bulk -file <bulk input file> [-template <pathname
+ of template file>] [-verbose] [-cell <cell name>] [-admin
+ <administrator to authenticate>] [-dryrun] [-skipauth] [-overwrite]
+ [-pwexpires <password expires in [0..254] days (0 => never)>] [-pipe]
[-help]
=head1 PRIVILEGE REQUIRED
=head1 SYNOPSIS
B<volinfo> [B<-online>] [B<-vnode>] [B<-date>] [B<-inode>] [B<-itime>]
- [B<-part> <I<AFS partition name (default current partition)>>+]
+ [B<-part> <I<AFS partition name (default current partition)>>+]
[B<-volumeid> <I<volume id>>+] [B<-header>] [B<-sizeOnly>]
[B<-fixheader>] [B<-saveinodes>] [B<-orphaned>] [B<-help>]
=head1 SYNOPSIS
-B<volserver> [B<-log>] [B<-p> <I<number of processes>>]
- [B<-udpsize> <I<size of socket buffer in bytes>>]
+B<volserver> [B<-log>] [B<-p> <I<number of processes>>]
+ [B<-udpsize> <I<size of socket buffer in bytes>>]
[B<-enable_peer_stats>] [B<-enable_process_stats>] [B<-help>]
=head1 DESCRIPTION
machine C<fs2.abc.com>:
% bos create -server fs2.abc.com -instance volserver -type simple \
- -cmd /usr/afs/bin/volserver
+ -cmd /usr/afs/bin/volserver
=head1 PRIVILEGE REQUIRED
git://git.openafs.org / openafs.git / commitdiff