mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 15:30:14 +00:00
f69bf0b194
- Mention the -help, -auth, -encrypt, and -config options for all pts commands in their synopsis - Add the -auth option to the pts.pod page - Reference the -auth, -encrypt, and -config options from all subcommand pts pages - pts_removeuser: Replace -name with -user - pts_sleep: Add missing -delay - pts_source: Add missing -file Change-Id: I4f0889d661c46f6bdd2a9604d8423d809a632d2d Reviewed-on: http://gerrit.openafs.org/10387 Tested-by: BuildBot <buildbot@rampaginggeek.com> Reviewed-by: Derrick Brashear <shadow@your-file-system.com>
118 lines
3.5 KiB
Plaintext
118 lines
3.5 KiB
Plaintext
=head1 NAME
|
|
|
|
pts_adduser - Adds a user or machine to a Protection Database group
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
=for html
|
|
<div class="synopsis">
|
|
|
|
B<pts adduser> S<<< B<-user> <I<user name>>+ >>> S<<< B<-group> <I<group name>>+ >>>
|
|
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>]
|
|
[B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
|
|
|
|
B<pts ad> S<<< B<-u> <I<user name>>+ >>> S<<< B<-g> <I<group name>>+ >>>
|
|
S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>]
|
|
[B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
|
|
|
|
=for html
|
|
</div>
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<pts adduser> command adds each user or machine entry named by the
|
|
B<-user> argument as a member of each group named by the B<-group>
|
|
argument.
|
|
|
|
To remove members of a group, use the B<pts removeuser> command. To list
|
|
the groups to which a user or machine belongs, or the members of a
|
|
specified group, use the B<pts membership> command.
|
|
|
|
=head1 CAUTIONS
|
|
|
|
After being added as a group member, a currently authenticated user must
|
|
reauthenticate (for example, by issuing the B<aklog> or B<klog.krb5> commands)
|
|
to obtain permissions granted to the group on an access control list (ACL).
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item B<-user> <I<user name>>+
|
|
|
|
Specifies the name of each user or machine entry to add to each group
|
|
named by the B<-group> argument. The name of a machine entry resembles an
|
|
IP address and can use the wildcard notation described on the B<pts
|
|
createuser> reference page. The user or machine entry must already exist
|
|
in the Protection Database.
|
|
|
|
=item B<-group> <I<group name>>+
|
|
|
|
Specifies the complete name (including the owner prefix if applicable) of
|
|
each group to which to add members. The group entry must already exist in
|
|
the Protection Database.
|
|
|
|
=include fragments/pts-common.pod
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
The following example adds user smith to the group system:administrators.
|
|
|
|
% pts adduser -user smith -group system:administrators
|
|
|
|
The following example adds users C<jones>, C<terry>, and B<pat> to the
|
|
smith:colleagues group.
|
|
|
|
% pts adduser -user jones terry pat -group smith:colleagues
|
|
|
|
The following example adds the machine entries in the Example Corporation
|
|
subnet to the group C<bin-prot>. Because of the IP address range of the
|
|
Example Corporation subnet, the system administrator was able to group the
|
|
machines into three machine entries (using the wildcard notation discussed
|
|
on the B<pts createuser> reference page).
|
|
|
|
% pts adduser -user 138.255.0.0 192.12.105.0 192.12.106.0 -group bin-prot
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
The required privilege depends on the setting of the fourth privacy flag
|
|
in the Protection Database entry for each group named by the B<-group>
|
|
argument (use the B<pts examine> command to display the flags):
|
|
|
|
=over 4
|
|
|
|
=item *
|
|
|
|
If it is the hyphen, only the group's owner and members of the
|
|
system:administrators group can add members.
|
|
|
|
=item *
|
|
|
|
If it is lowercase C<a>, current members of the group can add new members.
|
|
|
|
=item *
|
|
|
|
If it is uppercase C<A>, anyone who can access the cell's database server
|
|
machines can add new members.
|
|
|
|
=back
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<pts(1)>,
|
|
L<pts_createuser(1)>,
|
|
L<pts_examine(1)>,
|
|
L<pts_membership(1)>,
|
|
L<pts_removeuser(1)>,
|
|
L<pts_setfields(1)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|