xml-docbook-documentation-first-pass-20060915
[openafs.git] / doc / xml / UserGuide / c2454.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Using Groups</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
9 REL="HOME"
10 TITLE="AFS User Guide"
11 HREF="book1.html"><LINK
12 REL="PREVIOUS"
13 TITLE="Protecting Your Directories and Files"
14 HREF="c1444.html"><LINK
15 REL="NEXT"
16 TITLE="Troubleshooting"
17 HREF="c3402.html"></HEAD
18 ><BODY
19 CLASS="chapter"
20 BGCOLOR="#FFFFFF"
21 TEXT="#000000"
22 LINK="#0000FF"
23 VLINK="#840084"
24 ALINK="#0000FF"
25 ><DIV
26 CLASS="NAVHEADER"
27 ><TABLE
28 SUMMARY="Header navigation table"
29 WIDTH="100%"
30 BORDER="0"
31 CELLPADDING="0"
32 CELLSPACING="0"
33 ><TR
34 ><TH
35 COLSPAN="3"
36 ALIGN="center"
37 >AFS User Guide: Version 3.6</TH
38 ></TR
39 ><TR
40 ><TD
41 WIDTH="10%"
42 ALIGN="left"
43 VALIGN="bottom"
44 ><A
45 HREF="c1444.html"
46 ACCESSKEY="P"
47 >Prev</A
48 ></TD
49 ><TD
50 WIDTH="80%"
51 ALIGN="center"
52 VALIGN="bottom"
53 ></TD
54 ><TD
55 WIDTH="10%"
56 ALIGN="right"
57 VALIGN="bottom"
58 ><A
59 HREF="c3402.html"
60 ACCESSKEY="N"
61 >Next</A
62 ></TD
63 ></TR
64 ></TABLE
65 ><HR
66 ALIGN="LEFT"
67 WIDTH="100%"></DIV
68 ><DIV
69 CLASS="chapter"
70 ><H1
71 ><A
72 NAME="HDRWQ60"
73 ></A
74 >Chapter 5. Using Groups</H1
75 ><P
76 >This chapter explains how to create groups and discusses different ways to use them.</P
77 ><DIV
78 CLASS="sect1"
79 ><H1
80 CLASS="sect1"
81 ><A
82 NAME="HDRWQ61"
83 >About Groups</A
84 ></H1
85 ><P
86 >An AFS <SPAN
87 CLASS="emphasis"
88 ><I
89 CLASS="emphasis"
90 >group</I
91 ></SPAN
92 > is a list of specific users that you can place on access control lists (ACLs). Groups
93     make it much easier to maintain ACLs. Instead of creating an ACL entry for every user individually, you create one entry for a
94     group to which the users belong. Similarly, you can grant a user access to many directories at once by adding the user to a
95     group that appears on the relevant ACLs.</P
96 ><P
97 >AFS client machines can also belong to a group. Anyone logged into the machine inherits the permissions granted to the
98     group on an ACL, even if they are not authenticated with AFS. In general, groups of machines are useful only to system
99     administrators, for specialized purposes like complying with licensing agreements your cell has with software vendors. Talk with
100     your system administrator before putting a client machine in a group or using a machine group on an ACL.  </P
101 ><P
102 >To learn about AFS file protection and how to add groups to ACLs, see <A
103 HREF="c1444.html"
104 >Protecting Your Directories
105     and Files</A
106 >.</P
107 ><DIV
108 CLASS="sect2"
109 ><H2
110 CLASS="sect2"
111 ><A
112 NAME="HDRWQ62"
113 >Suggestions for Using Groups Effectively</A
114 ></H2
115 ><P
116 >There are three typical ways to use groups, each suited to a particular purpose: private use, shared use, and group use.
117       The following are only suggestions. You are free to use groups in any way you choose.</P
118 ><UL
119 ><LI
120 ><P
121 ><SPAN
122 CLASS="emphasis"
123 ><I
124 CLASS="emphasis"
125 >Private use</I
126 ></SPAN
127 >: you create a group and place it on the ACL of directories you own, without
128           necessarily informing the group's members that they belong to it. Members notice only that they can or cannot access the
129           directory in a certain way. You retain sole administrative control over the group, since you are the owner.  </P
130 ><P
131 >The existence of the group and the identity of its members is not necessarily secret. Other users can see the
132           group's name on an ACL when they use the <SPAN
133 CLASS="bold"
134 ><B
135 CLASS="emphasis"
136 >fs listacl</B
137 ></SPAN
138 > command, and can use the <SPAN
139 CLASS="bold"
140 ><B
141 CLASS="emphasis"
142 >pts membership</B
143 ></SPAN
144 > command to display + the groups to which they themselves belong. You can, however,
145           limit who can display the members of the group, as described in <A
146 HREF="c2454.html#HDRWQ74"
147 >Protecting Group-Related
148           Information</A
149 >.</P
150 ></LI
151 ><LI
152 ><P
153 ><SPAN
154 CLASS="emphasis"
155 ><I
156 CLASS="emphasis"
157 >Shared use</I
158 ></SPAN
159 >: you inform the group's members that they belong to the group, but you are the
160           group's sole owner and administrator. For example, the manager of a work group can create a group of all the members in
161           the work group, and encourage them to use it on the ACLs of directories that house information they want to share with
162           other members of the group.   <DIV
163 CLASS="note"
164 ><BLOCKQUOTE
165 CLASS="note"
166 ><P
167 ><B
168 >Note: </B
169 >If you place a group owned by someone else on your ACLs, the group's owner can change the group's membership
170               without informing you. Someone new can gain or lose access in a way you did not intend and without your
171               knowledge.</P
172 ></BLOCKQUOTE
173 ></DIV
174 ></P
175 ></LI
176 ><LI
177 ><P
178 ><SPAN
179 CLASS="emphasis"
180 ><I
181 CLASS="emphasis"
182 >Group use</I
183 ></SPAN
184 >: you create a group and then use the <SPAN
185 CLASS="bold"
186 ><B
187 CLASS="emphasis"
188 >pts chown</B
189 ></SPAN
190 >
191           command to assign ownership to a group--either another group or the group itself (the latter type is a
192           <SPAN
193 CLASS="emphasis"
194 ><I
195 CLASS="emphasis"
196 >self-owned</I
197 ></SPAN
198 > group). You inform the members of the owning group that they all can administer the owned
199           group. For instructions for the <SPAN
200 CLASS="bold"
201 ><B
202 CLASS="emphasis"
203 >pts chown</B
204 ></SPAN
205 > command, see <A
206 HREF="c2454.html#HDRWQ73"
207 >To Change
208           a Group's Owner</A
209 >.     </P
210 ><P
211 >The main advantage of designating a group as an owner is that several people share responsibility for administering
212           the group. A single person does not have to perform all administrative tasks, and if the group's original owner leaves the
213           cell, there are still other people who can administer it.</P
214 ><P
215 >However, everyone in the owner group can make changes that affect others negatively: adding or removing people from
216           the group inappropriately or changing the group's ownership to themselves exclusively. These problems can be particularly
217           sensitive in a self-owned group. Using an owner group works best if all the members know and trust each other; it is
218           probably wise to keep the number of people in an owner group small.</P
219 ></LI
220 ></UL
221 ></DIV
222 ><DIV
223 CLASS="sect2"
224 ><H2
225 CLASS="sect2"
226 ><A
227 NAME="HDRWQ63"
228 >Group Names</A
229 ></H2
230 ><P
231 >The groups you create must have names with two parts, in the following format:</P
232 ><P
233 ><VAR
234 CLASS="replaceable"
235 >owner_name</VAR
236 ><SPAN
237 CLASS="bold"
238 ><B
239 CLASS="emphasis"
240 >:</B
241 ></SPAN
242 ><VAR
243 CLASS="replaceable"
244 >group_name</VAR
245 ></P
246 ><P
247 >The <VAR
248 CLASS="replaceable"
249 >owner_name</VAR
250 > prefix indicates which user or group owns the group (naming rules appear in
251       <A
252 HREF="c2454.html#HDRWQ69"
253 >To Create a Group</A
254 >). The <VAR
255 CLASS="replaceable"
256 >group_name</VAR
257 > part indicates the group's
258       purpose or its members' common interest. Group names must always be typed in full, so a short
259       <VAR
260 CLASS="replaceable"
261 >group_name</VAR
262 > is most practical. However, names like <SPAN
263 CLASS="bold"
264 ><B
265 CLASS="emphasis"
266 >terry:1</B
267 ></SPAN
268 > and
269       <SPAN
270 CLASS="bold"
271 ><B
272 CLASS="emphasis"
273 >terry:2</B
274 ></SPAN
275 > that do not indicate the group's purpose are less useful than names like <SPAN
276 CLASS="bold"
277 ><B
278 CLASS="emphasis"
279 >terry:project</B
280 ></SPAN
281 >.</P
282 ><P
283 >Groups that do not have the <VAR
284 CLASS="replaceable"
285 >owner_name</VAR
286 > prefix possibly appear on some ACLs; they are created
287       by system administrators only. All of the groups you create must have an <VAR
288 CLASS="replaceable"
289 >owner_name</VAR
290 > prefix.</P
291 ></DIV
292 ><DIV
293 CLASS="sect2"
294 ><H2
295 CLASS="sect2"
296 ><A
297 NAME="Header_116"
298 >Group-creation Quota</A
299 ></H2
300 ><P
301 >By default, you can create 20 groups, but your system administrators can change your <SPAN
302 CLASS="emphasis"
303 ><I
304 CLASS="emphasis"
305 >group-creation
306       quota</I
307 ></SPAN
308 > if appropriate. When you create a group, your group quota decrements by one. When a group that you created is
309       deleted, your quota increments by one, even if you are no longer the owner. You cannot increase your quota by transferring
310       ownership of a group to someone else, because you are always recorded as the creator.</P
311 ><P
312 >If you exhaust your group-creation quota and need to create more groups, ask your system administrator. For instructions
313       for displaying your group-creation quota, see <A
314 HREF="c2454.html#HDRWQ67"
315 >To Display A Group Entry</A
316 >.</P
317 ></DIV
318 ></DIV
319 ><DIV
320 CLASS="sect1"
321 ><H1
322 CLASS="sect1"
323 ><A
324 NAME="HDRWQ64"
325 >Displaying Group Information</A
326 ></H1
327 ><P
328 >You can use the following commands to display information about groups and the users who belong to them:</P
329 ><UL
330 ><LI
331 ><P
332 >To display the members of a group, or the groups to which a user belongs, use the <SPAN
333 CLASS="bold"
334 ><B
335 CLASS="emphasis"
336 >pts
337         membership</B
338 ></SPAN
339 > command.</P
340 ></LI
341 ><LI
342 ><P
343 >To display the groups that a user or group owns, use the <SPAN
344 CLASS="bold"
345 ><B
346 CLASS="emphasis"
347 >pts listowned</B
348 ></SPAN
349 >
350         command.</P
351 ></LI
352 ><LI
353 ><P
354 >To display general information about a user or group, including its name, AFS ID, creator, and owner, use the
355         <SPAN
356 CLASS="bold"
357 ><B
358 CLASS="emphasis"
359 >pts examine</B
360 ></SPAN
361 > command.</P
362 ></LI
363 ></UL
364 ><DIV
365 CLASS="note"
366 ><BLOCKQUOTE
367 CLASS="note"
368 ><P
369 ><B
370 >Note: </B
371 >The <SPAN
372 CLASS="bold"
373 ><B
374 CLASS="emphasis"
375 >system:anyuser</B
376 ></SPAN
377 > and <SPAN
378 CLASS="bold"
379 ><B
380 CLASS="emphasis"
381 >system:authuser</B
382 ></SPAN
383 > system groups
384       do not appear in a user's list of group memberships, and the <SPAN
385 CLASS="bold"
386 ><B
387 CLASS="emphasis"
388 >pts membership</B
389 ></SPAN
390 > command does not
391       display their members. For more information on the system groups, see <A
392 HREF="c1444.html#HDRWQ50"
393 >Using the System Groups on
394       ACLs</A
395 >.</P
396 ></BLOCKQUOTE
397 ></DIV
398 ><DIV
399 CLASS="sect2"
400 ><H2
401 CLASS="sect2"
402 ><A
403 NAME="HDRWQ65"
404 >To Display Group Membership</A
405 ></H2
406 ><P
407 >Issue the <SPAN
408 CLASS="bold"
409 ><B
410 CLASS="emphasis"
411 >pts membership</B
412 ></SPAN
413 > command to display the members of a group, or the groups to
414       which a user belongs.</P
415 ><PRE
416 CLASS="programlisting"
417 >&#13;   % <SPAN
418 CLASS="bold"
419 ><B
420 CLASS="emphasis"
421 >pts membership</B
422 ></SPAN
423 > &#60;<VAR
424 CLASS="replaceable"
425 >user or group name or id</VAR
426 >&#62;<SUP
427 >+</SUP
428 >
429 </PRE
430 ><P
431 >where <VAR
432 CLASS="replaceable"
433 >user or group name or id</VAR
434 > specifies the name or AFS UID of each user for which to
435       display group membership, or the name or AFS GID of each group for which to display the members. If identifying a group by its
436       AFS GID, precede the GID with a hyphen (<SPAN
437 CLASS="bold"
438 ><B
439 CLASS="emphasis"
440 >-</B
441 ></SPAN
442 >) to indicate that it is a negative number.</P
443 ></DIV
444 ><DIV
445 CLASS="sect2"
446 ><H2
447 CLASS="sect2"
448 ><A
449 NAME="Header_119"
450 >Example: Displaying the Members of a Group</A
451 ></H2
452 ><P
453 >The following example displays the members of the group <SPAN
454 CLASS="bold"
455 ><B
456 CLASS="emphasis"
457 >terry:team</B
458 ></SPAN
459 >.</P
460 ><PRE
461 CLASS="programlisting"
462 >&#13;   % <SPAN
463 CLASS="bold"
464 ><B
465 CLASS="emphasis"
466 >pts membership terry:team</B
467 ></SPAN
468 >
469    Members of terry:team (id: -286) are:
470      terry
471      smith 
472      pat
473      johnson
474 </PRE
475 ></DIV
476 ><DIV
477 CLASS="sect2"
478 ><H2
479 CLASS="sect2"
480 ><A
481 NAME="Header_120"
482 >Example: Displaying the Groups to Which a User Belongs</A
483 ></H2
484 ><P
485 >The following example displays the groups to which users <SPAN
486 CLASS="bold"
487 ><B
488 CLASS="emphasis"
489 >terry</B
490 ></SPAN
491 > and <SPAN
492 CLASS="bold"
493 ><B
494 CLASS="emphasis"
495 >pat</B
496 ></SPAN
497 > belong.</P
498 ><PRE
499 CLASS="programlisting"
500 >&#13;   % <SPAN
501 CLASS="bold"
502 ><B
503 CLASS="emphasis"
504 >pts membership terry pat</B
505 ></SPAN
506 >
507    Groups terry (id: 1022) is a member of:
508      smith:friends
509      pat:accounting
510      terry:team
511    Groups pat (id: 1845) is a member of:
512      pat:accounting
513      sam:managers
514      terry:team
515 </PRE
516 ></DIV
517 ><DIV
518 CLASS="sect2"
519 ><H2
520 CLASS="sect2"
521 ><A
522 NAME="HDRWQ66"
523 >To Display the Groups a User or Group Owns</A
524 ></H2
525 ><P
526 >Issue the <SPAN
527 CLASS="bold"
528 ><B
529 CLASS="emphasis"
530 >pts listowned</B
531 ></SPAN
532 > command to display the groups that a user or group owns.</P
533 ><PRE
534 CLASS="programlisting"
535 >&#13;   %  <SPAN
536 CLASS="bold"
537 ><B
538 CLASS="emphasis"
539 >pts listowned</B
540 ></SPAN
541 > &#60;<VAR
542 CLASS="replaceable"
543 >user or group name or id</VAR
544 >&#62;<SUP
545 >+</SUP
546 >
547 </PRE
548 ><P
549 >where <VAR
550 CLASS="replaceable"
551 >user or group name or id</VAR
552 > specifies the name or AFS UID of each user, or the name or AFS
553       GID of each group, for which to display group ownership. If identifying a group by its AFS GID, precede the GID with a hyphen
554       (<SPAN
555 CLASS="bold"
556 ><B
557 CLASS="emphasis"
558 >-</B
559 ></SPAN
560 >) to indicate that it is a negative number.</P
561 ></DIV
562 ><DIV
563 CLASS="sect2"
564 ><H2
565 CLASS="sect2"
566 ><A
567 NAME="Header_122"
568 >Example: Displaying the Groups a Group Owns</A
569 ></H2
570 ><P
571 >The following example displays the groups that the group <SPAN
572 CLASS="bold"
573 ><B
574 CLASS="emphasis"
575 >terry:team</B
576 ></SPAN
577 > owns.</P
578 ><PRE
579 CLASS="programlisting"
580 >&#13;   % <SPAN
581 CLASS="bold"
582 ><B
583 CLASS="emphasis"
584 >pts listowned -286</B
585 ></SPAN
586 >
587    Groups owned by terry:team (id: -286) are:
588      terry:project
589      terry:planners
590 </PRE
591 ></DIV
592 ><DIV
593 CLASS="sect2"
594 ><H2
595 CLASS="sect2"
596 ><A
597 NAME="Header_123"
598 >Example: Displaying the Groups a User Owns</A
599 ></H2
600 ><P
601 >The following example displays the groups that user <SPAN
602 CLASS="bold"
603 ><B
604 CLASS="emphasis"
605 >pat</B
606 ></SPAN
607 > owns.</P
608 ><PRE
609 CLASS="programlisting"
610 >&#13;   % <SPAN
611 CLASS="bold"
612 ><B
613 CLASS="emphasis"
614 >pts listowned pat</B
615 ></SPAN
616 >
617    Groups owned by pat (id: 1845) are:
618       pat:accounting
619       pat:plans
620    
621 </PRE
622 ></DIV
623 ><DIV
624 CLASS="sect2"
625 ><H2
626 CLASS="sect2"
627 ><A
628 NAME="HDRWQ67"
629 >To Display A Group Entry</A
630 ></H2
631 ><P
632 >Issue the <SPAN
633 CLASS="bold"
634 ><B
635 CLASS="emphasis"
636 >pts examine</B
637 ></SPAN
638 > command to display general information about a user or group,
639       including its name, AFS ID, creator, and owner.</P
640 ><PRE
641 CLASS="programlisting"
642 >&#13;   %  <SPAN
643 CLASS="bold"
644 ><B
645 CLASS="emphasis"
646 >pts examine</B
647 ></SPAN
648 > &#60;<VAR
649 CLASS="replaceable"
650 >user or group name or id</VAR
651 >&#62;<SUP
652 >+</SUP
653 >
654 </PRE
655 ><P
656 >where <VAR
657 CLASS="replaceable"
658 >user or group name or id</VAR
659 > specifies the name or AFS UID of each user, or the name or AFS
660       GID of each group, for which to display group-related information. If identifying a group by its AFS GID, precede the GID with
661       a hyphen (<SPAN
662 CLASS="bold"
663 ><B
664 CLASS="emphasis"
665 >-</B
666 ></SPAN
667 >) to indicate that it is a negative number.</P
668 ><P
669 >The output includes information in the following fields:</P
670 ><DIV
671 CLASS="variablelist"
672 ><DL
673 ><DT
674 ><SPAN
675 CLASS="bold"
676 ><B
677 CLASS="emphasis"
678 ><SAMP
679 CLASS="computeroutput"
680 >Name</SAMP
681 ></B
682 ></SPAN
683 ></DT
684 ><DD
685 ><P
686 >For users, this is the character string typed when logging in. For machines, the name is the IP address; a zero in
687             address field acts as a wildcard, matching any value. For most groups, this is a name of the form
688             <VAR
689 CLASS="replaceable"
690 >owner_name</VAR
691 ><SPAN
692 CLASS="bold"
693 ><B
694 CLASS="emphasis"
695 >:</B
696 ></SPAN
697 ><VAR
698 CLASS="replaceable"
699 >group_name</VAR
700 >. Some
701             groups created by your system administrator do not have the <VAR
702 CLASS="replaceable"
703 >owner_name</VAR
704 > prefix. See <A
705 HREF="c2454.html#HDRWQ63"
706 >Group Names</A
707 >.</P
708 ></DD
709 ><DT
710 ><SPAN
711 CLASS="bold"
712 ><B
713 CLASS="emphasis"
714 ><SAMP
715 CLASS="computeroutput"
716 >id</SAMP
717 ></B
718 ></SPAN
719 ></DT
720 ><DD
721 ><P
722 >This is a unique identification number that the AFS server processes use internally. It is similar in function to
723             a UNIX UID, but operates in AFS rather than the UNIX file system. Users and machines have positive integer AFS user IDs
724             (UIDs), and groups have negative integer AFS group IDs (GIDs).   </P
725 ></DD
726 ><DT
727 ><SPAN
728 CLASS="bold"
729 ><B
730 CLASS="emphasis"
731 ><SAMP
732 CLASS="computeroutput"
733 >owner</SAMP
734 ></B
735 ></SPAN
736 ></DT
737 ><DD
738 ><P
739 >This is the user or group that owns the entry and so can administer it.</P
740 ></DD
741 ><DT
742 ><SPAN
743 CLASS="bold"
744 ><B
745 CLASS="emphasis"
746 ><SAMP
747 CLASS="computeroutput"
748 >creator</SAMP
749 ></B
750 ></SPAN
751 ></DT
752 ><DD
753 ><P
754 >The name of the user who issued the <SPAN
755 CLASS="bold"
756 ><B
757 CLASS="emphasis"
758 >pts createuser</B
759 ></SPAN
760 > and <SPAN
761 CLASS="bold"
762 ><B
763 CLASS="emphasis"
764 >pts
765             creategroup</B
766 ></SPAN
767 > command to create the entry. This field is useful mainly as an audit trail and cannot be
768             changed.</P
769 ></DD
770 ><DT
771 ><SPAN
772 CLASS="bold"
773 ><B
774 CLASS="emphasis"
775 ><SAMP
776 CLASS="computeroutput"
777 >membership</SAMP
778 ></B
779 ></SPAN
780 ></DT
781 ><DD
782 ><P
783 >For users and machines, this indicates how many groups the user or machine belongs to. For groups, it indicates
784             how many members belong to the group. This number cannot be set explicitly.</P
785 ></DD
786 ><DT
787 ><SPAN
788 CLASS="bold"
789 ><B
790 CLASS="emphasis"
791 ><SAMP
792 CLASS="computeroutput"
793 >flags</SAMP
794 ></B
795 ></SPAN
796 ></DT
797 ><DD
798 ><P
799 >This field indicates who is allowed to list certain information about the entry or change it in certain ways. See
800             <A
801 HREF="c2454.html#HDRWQ74"
802 >Protecting Group-Related Information</A
803 >.</P
804 ></DD
805 ><DT
806 ><SPAN
807 CLASS="bold"
808 ><B
809 CLASS="emphasis"
810 ><SAMP
811 CLASS="computeroutput"
812 >group quota</SAMP
813 ></B
814 ></SPAN
815 ></DT
816 ><DD
817 ><P
818 >This field indicates how many more groups a user is allowed to create. It is set to 20 when a user entry is
819             created. The creation quota for machines or groups is meaningless because it not possible to authenticate as a machine
820             or group.</P
821 ></DD
822 ></DL
823 ></DIV
824 ></DIV
825 ><DIV
826 CLASS="sect2"
827 ><H2
828 CLASS="sect2"
829 ><A
830 NAME="Header_125"
831 >Example: Listing Information about a Group</A
832 ></H2
833 ><P
834 >The following example displays information about the group <SPAN
835 CLASS="bold"
836 ><B
837 CLASS="emphasis"
838 >pat:accounting</B
839 ></SPAN
840 >, which
841       includes members of the department that <SPAN
842 CLASS="bold"
843 ><B
844 CLASS="emphasis"
845 >pat</B
846 ></SPAN
847 > manages. Notice that the group is self-owned,
848       which means that all of its members can administer it.</P
849 ><PRE
850 CLASS="programlisting"
851 >&#13;   % <SPAN
852 CLASS="bold"
853 ><B
854 CLASS="emphasis"
855 >pts examine pat:accounting</B
856 ></SPAN
857 >
858    Name: pat:accounting, id: -673, owner: pat:accounting, creator: pat,
859      membership: 15, flags: S-M--, group quota: 0
860 </PRE
861 ></DIV
862 ><DIV
863 CLASS="sect2"
864 ><H2
865 CLASS="sect2"
866 ><A
867 NAME="Header_126"
868 >Example: Listing Group Information about a User</A
869 ></H2
870 ><P
871 >The following example displays group-related information about user <SPAN
872 CLASS="bold"
873 ><B
874 CLASS="emphasis"
875 >pat</B
876 ></SPAN
877 >. The two most
878       interesting fields are <SAMP
879 CLASS="computeroutput"
880 >membership</SAMP
881 >, which shows that <SPAN
882 CLASS="bold"
883 ><B
884 CLASS="emphasis"
885 >pat</B
886 ></SPAN
887 >
888       belongs to 12 groups, and <SAMP
889 CLASS="computeroutput"
890 >group quota</SAMP
891 >, which shows that <SPAN
892 CLASS="bold"
893 ><B
894 CLASS="emphasis"
895 >pat</B
896 ></SPAN
897 >
898       can create another 17 groups.</P
899 ><PRE
900 CLASS="programlisting"
901 >&#13;  % <SPAN
902 CLASS="bold"
903 ><B
904 CLASS="emphasis"
905 >pts examine pat</B
906 ></SPAN
907 >
908    Name: pat, id: 1045, owner: system:administrators, creator: admin, 
909      membership: 12, flags: S-M--, group quota: 17
910 </PRE
911 ></DIV
912 ></DIV
913 ><DIV
914 CLASS="sect1"
915 ><H1
916 CLASS="sect1"
917 ><A
918 NAME="HDRWQ68"
919 >Creating Groups and Adding Members</A
920 ></H1
921 ><P
922 >Use the <SPAN
923 CLASS="bold"
924 ><B
925 CLASS="emphasis"
926 >pts creategroup</B
927 ></SPAN
928 > command to create a group and the <SPAN
929 CLASS="bold"
930 ><B
931 CLASS="emphasis"
932 >pts
933     adduser</B
934 ></SPAN
935 > command to add members to it. Users and machines can belong to groups, but other groups cannot.</P
936 ><P
937 >When you create a group, you normally become its owner automatically. This means you alone can administer it: add and
938     remove members, change the group's name, transfer ownership of the group, or delete the group entirely. If you wish, you can
939     designate another owner when you create the group, by including the <SPAN
940 CLASS="bold"
941 ><B
942 CLASS="emphasis"
943 >-owner</B
944 ></SPAN
945 > argument to the
946     <SPAN
947 CLASS="bold"
948 ><B
949 CLASS="emphasis"
950 >pts creategroup</B
951 ></SPAN
952 > command. If you assign ownership to another group, the owning group must
953     already exist and have at least one member. You can also change a group's ownership after creating it by using the <SPAN
954 CLASS="bold"
955 ><B
956 CLASS="emphasis"
957 >pts chown</B
958 ></SPAN
959 > command as described in <A
960 HREF="c2454.html#HDRWQ72"
961 >Changing a Group's Owner or Name</A
962 >.</P
963 ><DIV
964 CLASS="sect2"
965 ><H2
966 CLASS="sect2"
967 ><A
968 NAME="HDRWQ69"
969 >To Create a Group</A
970 ></H2
971 ><P
972 >Issue the <SPAN
973 CLASS="bold"
974 ><B
975 CLASS="emphasis"
976 >pts creategroup</B
977 ></SPAN
978 > command to create a group. Your group-creation quota
979       decrements by one for each group.</P
980 ><PRE
981 CLASS="programlisting"
982 >&#13;   % <SPAN
983 CLASS="bold"
984 ><B
985 CLASS="emphasis"
986 >pts creategroup -name</B
987 ></SPAN
988 > &#60;<VAR
989 CLASS="replaceable"
990 >group name</VAR
991 >&#62;+ [<SPAN
992 CLASS="bold"
993 ><B
994 CLASS="emphasis"
995 >-owner</B
996 ></SPAN
997 > &#60;<VAR
998 CLASS="replaceable"
999 >owner of the group</VAR
1000 >&#62;]
1001 </PRE
1002 ><P
1003 >where</P
1004 ><DIV
1005 CLASS="variablelist"
1006 ><DL
1007 ><DT
1008 ><SPAN
1009 CLASS="bold"
1010 ><B
1011 CLASS="emphasis"
1012 >cg</B
1013 ></SPAN
1014 ></DT
1015 ><DD
1016 ><P
1017 >Is an alias for <SPAN
1018 CLASS="bold"
1019 ><B
1020 CLASS="emphasis"
1021 >creategroup</B
1022 ></SPAN
1023 > (and <SPAN
1024 CLASS="bold"
1025 ><B
1026 CLASS="emphasis"
1027 >createg</B
1028 ></SPAN
1029 > is the
1030             shortest acceptable abbreviation).</P
1031 ></DD
1032 ><DT
1033 ><SPAN
1034 CLASS="bold"
1035 ><B
1036 CLASS="emphasis"
1037 >-name</B
1038 ></SPAN
1039 ></DT
1040 ><DD
1041 ><P
1042 >Names each group to create. The name must have the following format:</P
1043 ><P
1044 ><VAR
1045 CLASS="replaceable"
1046 >owner_name</VAR
1047 ><SPAN
1048 CLASS="bold"
1049 ><B
1050 CLASS="emphasis"
1051 >:</B
1052 ></SPAN
1053 ><VAR
1054 CLASS="replaceable"
1055 >group_name</VAR
1056 ></P
1057 ><P
1058 >The <VAR
1059 CLASS="replaceable"
1060 >owner_name</VAR
1061 > prefix must accurately indicate the group's owner. By default, you are
1062             recorded as the owner, and the <VAR
1063 CLASS="replaceable"
1064 >owner_name</VAR
1065 > must be your AFS username. You can include the
1066             <SPAN
1067 CLASS="bold"
1068 ><B
1069 CLASS="emphasis"
1070 >-owner</B
1071 ></SPAN
1072 > argument to designate another AFS user or group as the owner, as long as you
1073             provide the required value in the <VAR
1074 CLASS="replaceable"
1075 >owner_name</VAR
1076 > field:  </P
1077 ><UL
1078 ><LI
1079 ><P
1080 >If the owner is a user, it must be the AFS username.</P
1081 ></LI
1082 ><LI
1083 ><P
1084 >If the owner is another regular group, it must match the owning group's <VAR
1085 CLASS="replaceable"
1086 >owner_name</VAR
1087 >
1088                 field. For example, if the owner is the group <SPAN
1089 CLASS="bold"
1090 ><B
1091 CLASS="emphasis"
1092 >terry:associates</B
1093 ></SPAN
1094 >, the owner field
1095                 must be <SPAN
1096 CLASS="bold"
1097 ><B
1098 CLASS="emphasis"
1099 >terry</B
1100 ></SPAN
1101 >.</P
1102 ></LI
1103 ><LI
1104 ><P
1105 >If the owner is a group without an <VAR
1106 CLASS="replaceable"
1107 >owner_name</VAR
1108 > prefix, it must be the owning group's
1109                 name.</P
1110 ></LI
1111 ></UL
1112 ><P
1113 >The name can include up to 63 characters including the colon. Use numbers and lowercase letters, but no spaces or
1114             punctuation characters other than the colon.</P
1115 ></DD
1116 ><DT
1117 ><SPAN
1118 CLASS="bold"
1119 ><B
1120 CLASS="emphasis"
1121 >-owner</B
1122 ></SPAN
1123 ></DT
1124 ><DD
1125 ><P
1126 >Is optional and assigns ownership to a user other than yourself, or to a group. If you specify a group, it must
1127             already exist and have at least one member. (This means that to make a group self-owned, you must issue the <SPAN
1128 CLASS="bold"
1129 ><B
1130 CLASS="emphasis"
1131 >pts chown</B
1132 ></SPAN
1133 > command after using this command to create the group, and the <SPAN
1134 CLASS="bold"
1135 ><B
1136 CLASS="emphasis"
1137 >pts
1138             adduser</B
1139 ></SPAN
1140 > command to add a member. See <A
1141 HREF="c2454.html#HDRWQ72"
1142 >Changing a Group's Owner or Name</A
1143 >.)</P
1144 ><P
1145 >Do not name a machine as the owner. Because no one can authenticate as a machine, there is no way to administer a
1146             group owned by a machine.</P
1147 ></DD
1148 ></DL
1149 ></DIV
1150 ></DIV
1151 ><DIV
1152 CLASS="sect2"
1153 ><H2
1154 CLASS="sect2"
1155 ><A
1156 NAME="Header_129"
1157 >Example: Creating a Group</A
1158 ></H2
1159 ><P
1160 ></P
1161 ><P
1162 >In the following example user <SPAN
1163 CLASS="bold"
1164 ><B
1165 CLASS="emphasis"
1166 >terry</B
1167 ></SPAN
1168 > creates a group to include all the other users in
1169       his work team, and then examines the new group entry.</P
1170 ><PRE
1171 CLASS="programlisting"
1172 >&#13;   % <SPAN
1173 CLASS="bold"
1174 ><B
1175 CLASS="emphasis"
1176 >pts creategroup terry:team</B
1177 ></SPAN
1178 >
1179    group terry:team has id -286
1180    % <SPAN
1181 CLASS="bold"
1182 ><B
1183 CLASS="emphasis"
1184 >pts examine terry:team</B
1185 ></SPAN
1186 >
1187    Name: terry:team, id: -286, owner: terry, creator: terry, 
1188      membership: 0, flags: S----, group quota: 0.
1189 </PRE
1190 ></DIV
1191 ><DIV
1192 CLASS="sect2"
1193 ><H2
1194 CLASS="sect2"
1195 ><A
1196 NAME="HDRWQ70"
1197 >To Add Members to a Group</A
1198 ></H2
1199 ><P
1200 >Issue the <SPAN
1201 CLASS="bold"
1202 ><B
1203 CLASS="emphasis"
1204 >pts adduser</B
1205 ></SPAN
1206 > command to add one or more users to one or more groups. You can
1207       always add members to a group you own (either directly or because you belong to the owning group). If you belong to a group,
1208       you can add members if its fourth privacy flag is the lowercase letter <SPAN
1209 CLASS="bold"
1210 ><B
1211 CLASS="emphasis"
1212 >a</B
1213 ></SPAN
1214 >; see <A
1215 HREF="c2454.html#HDRWQ74"
1216 >Protecting Group-Related Information</A
1217 >.</P
1218 ><PRE
1219 CLASS="programlisting"
1220 >&#13;   % <SPAN
1221 CLASS="bold"
1222 ><B
1223 CLASS="emphasis"
1224 >pts adduser -user</B
1225 ></SPAN
1226 > &#60;<VAR
1227 CLASS="replaceable"
1228 >user name</VAR
1229 >&#62;<SUP
1230 >+</SUP
1231 > <SPAN
1232 CLASS="bold"
1233 ><B
1234 CLASS="emphasis"
1235 >-group</B
1236 ></SPAN
1237 > &#60;<VAR
1238 CLASS="replaceable"
1239 >group name</VAR
1240 >&#62;<SUP
1241 >+</SUP
1242 >
1243 </PRE
1244 ><P
1245 >You must add yourself to groups that you own, if that is appropriate. You do not belong automatically just because you
1246       own the group.</P
1247 ><DIV
1248 CLASS="note"
1249 ><BLOCKQUOTE
1250 CLASS="note"
1251 ><P
1252 ><B
1253 >Note: </B
1254 >If you already have a token when you are added to a group, you must issue the <SPAN
1255 CLASS="bold"
1256 ><B
1257 CLASS="emphasis"
1258 >klog</B
1259 ></SPAN
1260 >
1261         command to reauthenticate before you can exercise the permissions granted to the group on ACLs.</P
1262 ></BLOCKQUOTE
1263 ></DIV
1264 ><P
1265 >where</P
1266 ><DIV
1267 CLASS="variablelist"
1268 ><DL
1269 ><DT
1270 ><SPAN
1271 CLASS="bold"
1272 ><B
1273 CLASS="emphasis"
1274 >-user</B
1275 ></SPAN
1276 ></DT
1277 ><DD
1278 ><P
1279 >Specifies the username of each user to add to the groups named by the <SPAN
1280 CLASS="bold"
1281 ><B
1282 CLASS="emphasis"
1283 >-group</B
1284 ></SPAN
1285 >
1286             argument. Groups cannot belong to other groups.</P
1287 ></DD
1288 ><DT
1289 ><SPAN
1290 CLASS="bold"
1291 ><B
1292 CLASS="emphasis"
1293 >-group</B
1294 ></SPAN
1295 ></DT
1296 ><DD
1297 ><P
1298 >Names each group to which to add users.</P
1299 ></DD
1300 ></DL
1301 ></DIV
1302 ></DIV
1303 ><DIV
1304 CLASS="sect2"
1305 ><H2
1306 CLASS="sect2"
1307 ><A
1308 NAME="Header_131"
1309 >Example: Adding Members to a Group</A
1310 ></H2
1311 ><P
1312 >In this example, user <SPAN
1313 CLASS="bold"
1314 ><B
1315 CLASS="emphasis"
1316 >terry</B
1317 ></SPAN
1318 > adds himself, <SPAN
1319 CLASS="bold"
1320 ><B
1321 CLASS="emphasis"
1322 >pat</B
1323 ></SPAN
1324 >,
1325       <SPAN
1326 CLASS="bold"
1327 ><B
1328 CLASS="emphasis"
1329 >indira</B
1330 ></SPAN
1331 >, and <SPAN
1332 CLASS="bold"
1333 ><B
1334 CLASS="emphasis"
1335 >smith</B
1336 ></SPAN
1337 > to the group he just created, <SPAN
1338 CLASS="bold"
1339 ><B
1340 CLASS="emphasis"
1341 >terry:team</B
1342 ></SPAN
1343 >, and then verifies the new list of members.</P
1344 ><PRE
1345 CLASS="programlisting"
1346 >&#13;   % <SPAN
1347 CLASS="bold"
1348 ><B
1349 CLASS="emphasis"
1350 >pts adduser -user terry pat indira smith -group terry:team</B
1351 ></SPAN
1352 >
1353    % <SPAN
1354 CLASS="bold"
1355 ><B
1356 CLASS="emphasis"
1357 >pts members terry:team</B
1358 ></SPAN
1359 >
1360    Members of terry:team (id: -286) are:
1361      terry
1362      pat
1363      indira
1364      smith
1365 </PRE
1366 ></DIV
1367 ></DIV
1368 ><DIV
1369 CLASS="sect1"
1370 ><H1
1371 CLASS="sect1"
1372 ><A
1373 NAME="HDRWQ71"
1374 >Removing Users from a Group and Deleting a Group</A
1375 ></H1
1376 ><P
1377 >You can use the following commands to remove groups and their members:</P
1378 ><UL
1379 ><LI
1380 ><P
1381 >To remove a user from a group, use the <SPAN
1382 CLASS="bold"
1383 ><B
1384 CLASS="emphasis"
1385 >pts removeuser</B
1386 ></SPAN
1387 > command</P
1388 ></LI
1389 ><LI
1390 ><P
1391 >To delete a group entirely, use the <SPAN
1392 CLASS="bold"
1393 ><B
1394 CLASS="emphasis"
1395 >pts delete</B
1396 ></SPAN
1397 > command</P
1398 ></LI
1399 ><LI
1400 ><P
1401 >To remove deleted groups from ACLs, use the <SPAN
1402 CLASS="bold"
1403 ><B
1404 CLASS="emphasis"
1405 >fs cleanacl</B
1406 ></SPAN
1407 > command</P
1408 ></LI
1409 ></UL
1410 ><P
1411 >When a group that you created is deleted, your group-creation quota increments by one, even if you no longer own the
1412     group.</P
1413 ><P
1414 >When a group or user is deleted, its AFS ID appears on ACLs in place of its AFS name. You can use the <SPAN
1415 CLASS="bold"
1416 ><B
1417 CLASS="emphasis"
1418 >fs cleanacl</B
1419 ></SPAN
1420 > command to remove these obsolete entries from ACLs on which you have the <SPAN
1421 CLASS="bold"
1422 ><B
1423 CLASS="emphasis"
1424 >a</B
1425 ></SPAN
1426 > (<SPAN
1427 CLASS="bold"
1428 ><B
1429 CLASS="emphasis"
1430 >administer</B
1431 ></SPAN
1432 >) permission.</P
1433 ><DIV
1434 CLASS="sect2"
1435 ><H2
1436 CLASS="sect2"
1437 ><A
1438 NAME="Header_133"
1439 >To Remove Members from a Group</A
1440 ></H2
1441 ><P
1442 >Issue the <SPAN
1443 CLASS="bold"
1444 ><B
1445 CLASS="emphasis"
1446 >pts removeuser</B
1447 ></SPAN
1448 > command to remove one or more members from one or more groups.
1449       You can always remove members from a group that you own (either directly or because you belong to the owning group). If you
1450       belong to a group, you can remove members if its fifth privacy flag is the lowercase letter <SPAN
1451 CLASS="bold"
1452 ><B
1453 CLASS="emphasis"
1454 >r</B
1455 ></SPAN
1456 >; see <A
1457 HREF="c2454.html#HDRWQ74"
1458 >Protecting Group-Related Information</A
1459 >. (To display a group's
1460       owner, use the <SPAN
1461 CLASS="bold"
1462 ><B
1463 CLASS="emphasis"
1464 >pts examine</B
1465 ></SPAN
1466 > command as described in <A
1467 HREF="c2454.html#HDRWQ67"
1468 >To Display A Group
1469       Entry</A
1470 >.)</P
1471 ><PRE
1472 CLASS="programlisting"
1473 >&#13;   % <SPAN
1474 CLASS="bold"
1475 ><B
1476 CLASS="emphasis"
1477 >pts removeuser -user</B
1478 ></SPAN
1479 >  &#60;<VAR
1480 CLASS="replaceable"
1481 >user name</VAR
1482 >&#62;<SUP
1483 >+</SUP
1484 >  <SPAN
1485 CLASS="bold"
1486 ><B
1487 CLASS="emphasis"
1488 >-group</B
1489 ></SPAN
1490 > &#60;<VAR
1491 CLASS="replaceable"
1492 >group name</VAR
1493 >&#62;<SUP
1494 >+</SUP
1495 >
1496 </PRE
1497 ><P
1498 >where</P
1499 ><DIV
1500 CLASS="variablelist"
1501 ><DL
1502 ><DT
1503 ><SPAN
1504 CLASS="bold"
1505 ><B
1506 CLASS="emphasis"
1507 >-user</B
1508 ></SPAN
1509 ></DT
1510 ><DD
1511 ><P
1512 >Specifies the username of each user to remove from the groups named by the <SPAN
1513 CLASS="bold"
1514 ><B
1515 CLASS="emphasis"
1516 >-group</B
1517 ></SPAN
1518 >
1519             argument.</P
1520 ></DD
1521 ><DT
1522 ><SPAN
1523 CLASS="bold"
1524 ><B
1525 CLASS="emphasis"
1526 >-group</B
1527 ></SPAN
1528 ></DT
1529 ><DD
1530 ><P
1531 >Names each group from which to remove users.</P
1532 ></DD
1533 ></DL
1534 ></DIV
1535 ></DIV
1536 ><DIV
1537 CLASS="sect2"
1538 ><H2
1539 CLASS="sect2"
1540 ><A
1541 NAME="Header_134"
1542 >Example: Removing Group Members</A
1543 ></H2
1544 ><P
1545 >The following example removes user <SPAN
1546 CLASS="bold"
1547 ><B
1548 CLASS="emphasis"
1549 >pat</B
1550 ></SPAN
1551 > from both the <SPAN
1552 CLASS="bold"
1553 ><B
1554 CLASS="emphasis"
1555 >terry:team</B
1556 ></SPAN
1557 > and <SPAN
1558 CLASS="bold"
1559 ><B
1560 CLASS="emphasis"
1561 >terry:friends</B
1562 ></SPAN
1563 > groups.</P
1564 ><PRE
1565 CLASS="programlisting"
1566 >&#13;   % <SPAN
1567 CLASS="bold"
1568 ><B
1569 CLASS="emphasis"
1570 >pts removeuser  pat -group terry:team terry:friends</B
1571 ></SPAN
1572 >
1573 </PRE
1574 ></DIV
1575 ><DIV
1576 CLASS="sect2"
1577 ><H2
1578 CLASS="sect2"
1579 ><A
1580 NAME="Header_135"
1581 >To Delete a Group</A
1582 ></H2
1583 ><P
1584 >Issue the <SPAN
1585 CLASS="bold"
1586 ><B
1587 CLASS="emphasis"
1588 >pts delete</B
1589 ></SPAN
1590 > command to delete a group. You can always delete a group that you
1591       own (either directly or because you belong to the owning group). To display a group's owner, use the <SPAN
1592 CLASS="bold"
1593 ><B
1594 CLASS="emphasis"
1595 >pts
1596       examine</B
1597 ></SPAN
1598 > command as described in <A
1599 HREF="c2454.html#HDRWQ67"
1600 >To Display A Group Entry</A
1601 >.</P
1602 ><PRE
1603 CLASS="programlisting"
1604 >&#13;   % <SPAN
1605 CLASS="bold"
1606 ><B
1607 CLASS="emphasis"
1608 >pts delete</B
1609 ></SPAN
1610 > &#60;<VAR
1611 CLASS="replaceable"
1612 >user or group name or id</VAR
1613 >&#62;<SUP
1614 >+</SUP
1615 >
1616 </PRE
1617 ><P
1618 >where <VAR
1619 CLASS="replaceable"
1620 >user or group name or id</VAR
1621 > specifies the name or AFS UID of each user, or the name or AFS
1622       GID of each group, to delete. If identifying a group by its AFS GID, precede the GID with a hyphen (<SPAN
1623 CLASS="bold"
1624 ><B
1625 CLASS="emphasis"
1626 >-</B
1627 ></SPAN
1628 >) to indicate that it is a negative number.</P
1629 ></DIV
1630 ><DIV
1631 CLASS="sect2"
1632 ><H2
1633 CLASS="sect2"
1634 ><A
1635 NAME="Header_136"
1636 >Example: Deleting a Group</A
1637 ></H2
1638 ><P
1639 ></P
1640 ><P
1641 >In the following example, the group <SPAN
1642 CLASS="bold"
1643 ><B
1644 CLASS="emphasis"
1645 >terry:team</B
1646 ></SPAN
1647 > is deleted.</P
1648 ><PRE
1649 CLASS="programlisting"
1650 >&#13;   % <SPAN
1651 CLASS="bold"
1652 ><B
1653 CLASS="emphasis"
1654 >pts delete terry:team</B
1655 ></SPAN
1656 >
1657 </PRE
1658 ></DIV
1659 ><DIV
1660 CLASS="sect2"
1661 ><H2
1662 CLASS="sect2"
1663 ><A
1664 NAME="Header_137"
1665 >To Remove Obsolete ACL Entries</A
1666 ></H2
1667 ><P
1668 >Issue the <SPAN
1669 CLASS="bold"
1670 ><B
1671 CLASS="emphasis"
1672 >fs cleanacl</B
1673 ></SPAN
1674 > command to remove obsolete entries from ACLs after the
1675       corresponding user or group has been deleted.</P
1676 ><PRE
1677 CLASS="programlisting"
1678 >&#13;   % <SPAN
1679 CLASS="bold"
1680 ><B
1681 CLASS="emphasis"
1682 >fs cleanacl</B
1683 ></SPAN
1684 > [&#60;<VAR
1685 CLASS="replaceable"
1686 >dir/file path</VAR
1687 >&#62;<SUP
1688 >+</SUP
1689 >]
1690 </PRE
1691 ><P
1692 >where <VAR
1693 CLASS="replaceable"
1694 >dir/file path</VAR
1695 > name each directory for which to clean the ACL. If you omit this
1696       argument, the current working directory's ACL is cleaned.</P
1697 ><P
1698 ></P
1699 ></DIV
1700 ><DIV
1701 CLASS="sect2"
1702 ><H2
1703 CLASS="sect2"
1704 ><A
1705 NAME="Header_138"
1706 >Example: Removing an Obsolete ACL Entry</A
1707 ></H2
1708 ><P
1709 >After the group <SPAN
1710 CLASS="bold"
1711 ><B
1712 CLASS="emphasis"
1713 >terry:team</B
1714 ></SPAN
1715 > is deleted, its AFS GID (-286) appears on ACLs instead of
1716       its name. In this example, user <SPAN
1717 CLASS="bold"
1718 ><B
1719 CLASS="emphasis"
1720 >terry</B
1721 ></SPAN
1722 > cleans it from the ACL on the plans directory in his
1723       home directory.</P
1724 ><PRE
1725 CLASS="programlisting"
1726 >&#13;   % <SPAN
1727 CLASS="bold"
1728 ><B
1729 CLASS="emphasis"
1730 >fs listacl plans</B
1731 ></SPAN
1732 >
1733    Access list for plans is
1734    Normal rights:
1735      terry rlidwka
1736      -268 rlidwk
1737      sam rliw
1738    % <SPAN
1739 CLASS="bold"
1740 ><B
1741 CLASS="emphasis"
1742 >fs cleanacl plans</B
1743 ></SPAN
1744 >
1745    % <SPAN
1746 CLASS="bold"
1747 ><B
1748 CLASS="emphasis"
1749 >fs listacl plans</B
1750 ></SPAN
1751 >
1752    Access list for plans is
1753    Normal rights:
1754      terry rlidwka
1755      sam rliw
1756 </PRE
1757 ></DIV
1758 ></DIV
1759 ><DIV
1760 CLASS="sect1"
1761 ><H1
1762 CLASS="sect1"
1763 ><A
1764 NAME="HDRWQ72"
1765 >Changing a Group's Owner or Name</A
1766 ></H1
1767 ><P
1768 >To change a group's owner, use the <SPAN
1769 CLASS="bold"
1770 ><B
1771 CLASS="emphasis"
1772 >pts chown</B
1773 ></SPAN
1774 > command. To change its name, use the
1775     <SPAN
1776 CLASS="bold"
1777 ><B
1778 CLASS="emphasis"
1779 >pts rename</B
1780 ></SPAN
1781 > command.</P
1782 ><P
1783 >You can change the owner or name of a group that you own (either directly or because you belong to the owning group). You
1784     can assign group ownership to another user, another group, or the group itself. If you are not already a member of the group and
1785     need to be, use the <SPAN
1786 CLASS="bold"
1787 ><B
1788 CLASS="emphasis"
1789 >pts adduser</B
1790 ></SPAN
1791 > command before transferring ownership, following the
1792     instructions in <A
1793 HREF="c2454.html#HDRWQ70"
1794 >To Add Members to a Group</A
1795 >.</P
1796 ><P
1797 >The <SPAN
1798 CLASS="bold"
1799 ><B
1800 CLASS="emphasis"
1801 >pts chown</B
1802 ></SPAN
1803 > command automatically changes a group's
1804     <VAR
1805 CLASS="replaceable"
1806 >owner_name</VAR
1807 > prefix to indicate the new owner. If the new owner is a group, only its
1808     <VAR
1809 CLASS="replaceable"
1810 >owner_name</VAR
1811 > prefix is used, not its entire name. However, the change in
1812     <VAR
1813 CLASS="replaceable"
1814 >owner_name</VAR
1815 > prefix command does not propagate to any groups owned by the group whose owner is
1816     changing. If you want their <VAR
1817 CLASS="replaceable"
1818 >owner_name</VAR
1819 > prefixes to indicate the correct owner, you must use the
1820     <SPAN
1821 CLASS="bold"
1822 ><B
1823 CLASS="emphasis"
1824 >pts rename</B
1825 ></SPAN
1826 > command.</P
1827 ><P
1828 >Otherwise, you normally use the <SPAN
1829 CLASS="bold"
1830 ><B
1831 CLASS="emphasis"
1832 >pts rename</B
1833 ></SPAN
1834 > command to change only the
1835     <VAR
1836 CLASS="replaceable"
1837 >group_name</VAR
1838 > part of a group name (the part that follows the colon). You can change the
1839     <VAR
1840 CLASS="replaceable"
1841 >owner_name</VAR
1842 > prefix only to reflect the actual owner.</P
1843 ><DIV
1844 CLASS="sect2"
1845 ><H2
1846 CLASS="sect2"
1847 ><A
1848 NAME="HDRWQ73"
1849 >To Change a Group's Owner</A
1850 ></H2
1851 ><P
1852 >Issue the <SPAN
1853 CLASS="bold"
1854 ><B
1855 CLASS="emphasis"
1856 >pts chown</B
1857 ></SPAN
1858 > command to change a group's name.</P
1859 ><PRE
1860 CLASS="programlisting"
1861 >&#13;   % <SPAN
1862 CLASS="bold"
1863 ><B
1864 CLASS="emphasis"
1865 >pts chown</B
1866 ></SPAN
1867 >  &#60;<VAR
1868 CLASS="replaceable"
1869 >group name</VAR
1870 >&#62; &#60;<VAR
1871 CLASS="replaceable"
1872 >new owner</VAR
1873 >&#62;
1874 </PRE
1875 ><P
1876 >where</P
1877 ><DIV
1878 CLASS="variablelist"
1879 ><DL
1880 ><DT
1881 ><SPAN
1882 CLASS="bold"
1883 ><B
1884 CLASS="emphasis"
1885 ><VAR
1886 CLASS="replaceable"
1887 >group name</VAR
1888 ></B
1889 ></SPAN
1890 ></DT
1891 ><DD
1892 ><P
1893 >Specifies the current name of the group to which to assign a new owner.</P
1894 ></DD
1895 ><DT
1896 ><SPAN
1897 CLASS="bold"
1898 ><B
1899 CLASS="emphasis"
1900 ><VAR
1901 CLASS="replaceable"
1902 >new owner</VAR
1903 ></B
1904 ></SPAN
1905 ></DT
1906 ><DD
1907 ><P
1908 >Names the user or group that is to own the group.</P
1909 ></DD
1910 ></DL
1911 ></DIV
1912 ></DIV
1913 ><DIV
1914 CLASS="sect2"
1915 ><H2
1916 CLASS="sect2"
1917 ><A
1918 NAME="Header_141"
1919 >Example: Changing a Group's Owner to Another User</A
1920 ></H2
1921 ><P
1922 >In the following example, user <SPAN
1923 CLASS="bold"
1924 ><B
1925 CLASS="emphasis"
1926 >pat</B
1927 ></SPAN
1928 > transfers ownership of the group <SPAN
1929 CLASS="bold"
1930 ><B
1931 CLASS="emphasis"
1932 >pat:staff</B
1933 ></SPAN
1934 > to user <SPAN
1935 CLASS="bold"
1936 ><B
1937 CLASS="emphasis"
1938 >terry</B
1939 ></SPAN
1940 >. Its name changes automatically to <SPAN
1941 CLASS="bold"
1942 ><B
1943 CLASS="emphasis"
1944 >terry:staff</B
1945 ></SPAN
1946 >, as confirmed by the <SPAN
1947 CLASS="bold"
1948 ><B
1949 CLASS="emphasis"
1950 >pts examine</B
1951 ></SPAN
1952 > command.</P
1953 ><PRE
1954 CLASS="programlisting"
1955 >&#13;   % <SPAN
1956 CLASS="bold"
1957 ><B
1958 CLASS="emphasis"
1959 >pts chown pat:staff terry</B
1960 ></SPAN
1961 >
1962    % <SPAN
1963 CLASS="bold"
1964 ><B
1965 CLASS="emphasis"
1966 >pts examine terry:staff</B
1967 ></SPAN
1968
1969    Name: terry:staff, id: -534, owner: terry, creator: pat, 
1970      membership: 15, flags: SOm--, group quota: 0.
1971 </PRE
1972 ></DIV
1973 ><DIV
1974 CLASS="sect2"
1975 ><H2
1976 CLASS="sect2"
1977 ><A
1978 NAME="Header_142"
1979 >Example: Changing a Group's Owner to Itself</A
1980 ></H2
1981 ><P
1982 >In the following example, user <SPAN
1983 CLASS="bold"
1984 ><B
1985 CLASS="emphasis"
1986 >terry</B
1987 ></SPAN
1988 > makes the <SPAN
1989 CLASS="bold"
1990 ><B
1991 CLASS="emphasis"
1992 >terry:team</B
1993 ></SPAN
1994 > group a self-owned group. Its name does not change because its
1995       <VAR
1996 CLASS="replaceable"
1997 >owner_name</VAR
1998 > prefix is already <SPAN
1999 CLASS="bold"
2000 ><B
2001 CLASS="emphasis"
2002 >terry</B
2003 ></SPAN
2004 >.</P
2005 ><PRE
2006 CLASS="programlisting"
2007 >&#13;   % <SPAN
2008 CLASS="bold"
2009 ><B
2010 CLASS="emphasis"
2011 >pts chown terry:team terry:team</B
2012 ></SPAN
2013 >
2014    % <SPAN
2015 CLASS="bold"
2016 ><B
2017 CLASS="emphasis"
2018 >pts examine terry:team</B
2019 ></SPAN
2020 >
2021    Name: terry:team, id: -286, owner: terry:team, creator: terry, 
2022      membership: 6, flags: SOm--, group quota: 0.
2023 </PRE
2024 ></DIV
2025 ><DIV
2026 CLASS="sect2"
2027 ><H2
2028 CLASS="sect2"
2029 ><A
2030 NAME="Header_143"
2031 >Example: Changing a Group's Owner to a Group</A
2032 ></H2
2033 ><P
2034 >In this example, user <SPAN
2035 CLASS="bold"
2036 ><B
2037 CLASS="emphasis"
2038 >sam</B
2039 ></SPAN
2040 > transfers ownership of the group <SPAN
2041 CLASS="bold"
2042 ><B
2043 CLASS="emphasis"
2044 >sam:project</B
2045 ></SPAN
2046 > to the group <SPAN
2047 CLASS="bold"
2048 ><B
2049 CLASS="emphasis"
2050 >smith:cpa</B
2051 ></SPAN
2052 >. Its name changes automatically to
2053       <SPAN
2054 CLASS="bold"
2055 ><B
2056 CLASS="emphasis"
2057 >smith:project</B
2058 ></SPAN
2059 >, because <SPAN
2060 CLASS="bold"
2061 ><B
2062 CLASS="emphasis"
2063 >smith</B
2064 ></SPAN
2065 > is the
2066       <VAR
2067 CLASS="replaceable"
2068 >owner_name</VAR
2069 > prefix of the group that now owns it. The <SPAN
2070 CLASS="bold"
2071 ><B
2072 CLASS="emphasis"
2073 >pts examine</B
2074 ></SPAN
2075 >
2076       command displays the group's status before and after the change.</P
2077 ><PRE
2078 CLASS="programlisting"
2079 >&#13;   % <SPAN
2080 CLASS="bold"
2081 ><B
2082 CLASS="emphasis"
2083 >pts examine sam:project</B
2084 ></SPAN
2085 >
2086    Name: sam:project, id: -522, owner: sam, creator: sam, 
2087      membership: 33, flags: SOm--, group quota: 0.
2088    % <SPAN
2089 CLASS="bold"
2090 ><B
2091 CLASS="emphasis"
2092 >pts chown sam:project smith:cpa</B
2093 ></SPAN
2094 >
2095    % <SPAN
2096 CLASS="bold"
2097 ><B
2098 CLASS="emphasis"
2099 >pts examine smith:project</B
2100 ></SPAN
2101 >
2102    Name: smith:project, id: -522, owner: smith:cpa, creator: sam, 
2103      membership: 33, flags: SOm--, group quota: 0.
2104 </PRE
2105 ></DIV
2106 ><DIV
2107 CLASS="sect2"
2108 ><H2
2109 CLASS="sect2"
2110 ><A
2111 NAME="Header_144"
2112 >To Change a Group's Name</A
2113 ></H2
2114 ><P
2115 >Issue the <SPAN
2116 CLASS="bold"
2117 ><B
2118 CLASS="emphasis"
2119 >pts rename</B
2120 ></SPAN
2121 > command to change a group's name.</P
2122 ><PRE
2123 CLASS="programlisting"
2124 >&#13;   % <SPAN
2125 CLASS="bold"
2126 ><B
2127 CLASS="emphasis"
2128 >pts rename</B
2129 ></SPAN
2130 >  &#60;<VAR
2131 CLASS="replaceable"
2132 >old name</VAR
2133 >&#62; &#60;<VAR
2134 CLASS="replaceable"
2135 >new name</VAR
2136 >&#62;
2137 </PRE
2138 ><P
2139 >where</P
2140 ><DIV
2141 CLASS="variablelist"
2142 ><DL
2143 ><DT
2144 ><SPAN
2145 CLASS="bold"
2146 ><B
2147 CLASS="emphasis"
2148 ><VAR
2149 CLASS="replaceable"
2150 >old name</VAR
2151 ></B
2152 ></SPAN
2153 ></DT
2154 ><DD
2155 ><P
2156 >Specifies the group's current name.</P
2157 ></DD
2158 ><DT
2159 ><SPAN
2160 CLASS="bold"
2161 ><B
2162 CLASS="emphasis"
2163 ><VAR
2164 CLASS="replaceable"
2165 >new name</VAR
2166 ></B
2167 ></SPAN
2168 ></DT
2169 ><DD
2170 ><P
2171 >Specifies the complete new name to assign to the group. The <VAR
2172 CLASS="replaceable"
2173 >owner_name</VAR
2174 > prefix must
2175             correctly indicate the group's owner.</P
2176 ></DD
2177 ></DL
2178 ></DIV
2179 ></DIV
2180 ><DIV
2181 CLASS="sect2"
2182 ><H2
2183 CLASS="sect2"
2184 ><A
2185 NAME="Header_145"
2186 >Example: Changing a Group's <VAR
2187 CLASS="replaceable"
2188 >group_name</VAR
2189 > Suffix</A
2190 ></H2
2191 ><P
2192 >The following example changes the name of the <SPAN
2193 CLASS="bold"
2194 ><B
2195 CLASS="emphasis"
2196 >smith:project</B
2197 ></SPAN
2198 > group to <SPAN
2199 CLASS="bold"
2200 ><B
2201 CLASS="emphasis"
2202 >smith:fiscal-closing</B
2203 ></SPAN
2204 >. The group's <VAR
2205 CLASS="replaceable"
2206 >owner_name</VAR
2207 > prefix remains <SPAN
2208 CLASS="bold"
2209 ><B
2210 CLASS="emphasis"
2211 >smith</B
2212 ></SPAN
2213 > because its owner is not changing.</P
2214 ><PRE
2215 CLASS="programlisting"
2216 >&#13;   % <SPAN
2217 CLASS="bold"
2218 ><B
2219 CLASS="emphasis"
2220 >pts examine smith:project</B
2221 ></SPAN
2222 >
2223    Name: smith:project, id: -522, owner: smith:cpa, creator: sam, 
2224      membership: 33, flags: SOm--, group quota: 0.
2225    % <SPAN
2226 CLASS="bold"
2227 ><B
2228 CLASS="emphasis"
2229 >pts rename smith:project smith:fiscal-closing</B
2230 ></SPAN
2231 >
2232    % <SPAN
2233 CLASS="bold"
2234 ><B
2235 CLASS="emphasis"
2236 >pts examine smith:fiscal-closing</B
2237 ></SPAN
2238 >
2239    Name: smith:fiscal-closing, id: -522, owner: smith:cpa, creator: sam, 
2240      membership: 33, flags: SOm--, group quota: 0.
2241 </PRE
2242 ></DIV
2243 ><DIV
2244 CLASS="sect2"
2245 ><H2
2246 CLASS="sect2"
2247 ><A
2248 NAME="Header_146"
2249 >Example: Changing a Group's <VAR
2250 CLASS="replaceable"
2251 >owner_name</VAR
2252 > Prefix</A
2253 ></H2
2254 ><P
2255 >In a previous example, user <SPAN
2256 CLASS="bold"
2257 ><B
2258 CLASS="emphasis"
2259 >pat</B
2260 ></SPAN
2261 > transferred ownership of the group <SPAN
2262 CLASS="bold"
2263 ><B
2264 CLASS="emphasis"
2265 >pat:staff</B
2266 ></SPAN
2267 > to user <SPAN
2268 CLASS="bold"
2269 ><B
2270 CLASS="emphasis"
2271 >terry</B
2272 ></SPAN
2273 >. Its name changed automatically to <SPAN
2274 CLASS="bold"
2275 ><B
2276 CLASS="emphasis"
2277 >terry:staff</B
2278 ></SPAN
2279 >. However, a group that <SPAN
2280 CLASS="bold"
2281 ><B
2282 CLASS="emphasis"
2283 >terry:staff</B
2284 ></SPAN
2285 > owns is still called
2286       <SPAN
2287 CLASS="bold"
2288 ><B
2289 CLASS="emphasis"
2290 >pat:plans</B
2291 ></SPAN
2292 >, because the change to a group's <VAR
2293 CLASS="replaceable"
2294 >owner_name</VAR
2295 > that results
2296       from the <SPAN
2297 CLASS="bold"
2298 ><B
2299 CLASS="emphasis"
2300 >pts chown</B
2301 ></SPAN
2302 > command does not propagate to any groups it owns. In this example, a
2303       member of <SPAN
2304 CLASS="bold"
2305 ><B
2306 CLASS="emphasis"
2307 >terry:staff</B
2308 ></SPAN
2309 > uses the <SPAN
2310 CLASS="bold"
2311 ><B
2312 CLASS="emphasis"
2313 >pts rename</B
2314 ></SPAN
2315 > command to change
2316       the name to <SPAN
2317 CLASS="bold"
2318 ><B
2319 CLASS="emphasis"
2320 >terry:plans</B
2321 ></SPAN
2322 > to reflect its actual ownership.</P
2323 ><PRE
2324 CLASS="programlisting"
2325 >&#13;   % <SPAN
2326 CLASS="bold"
2327 ><B
2328 CLASS="emphasis"
2329 >pts examine pat:plans</B
2330 ></SPAN
2331
2332    Name: pat:plans, id: -535, owner: terry:staff, creator: pat, 
2333      membership: 8, flags: SOm--, group quota: 0.
2334    % <SPAN
2335 CLASS="bold"
2336 ><B
2337 CLASS="emphasis"
2338 >pts rename pat:plans terry:plans</B
2339 ></SPAN
2340 >
2341    % <SPAN
2342 CLASS="bold"
2343 ><B
2344 CLASS="emphasis"
2345 >pts examine terry:plans</B
2346 ></SPAN
2347
2348    Name: terry:plans, id: -535, owner: terry:staff, creator: pat, 
2349      membership: 8, flags: SOm--, group quota: 0.
2350 </PRE
2351 ></DIV
2352 ></DIV
2353 ><DIV
2354 CLASS="sect1"
2355 ><H1
2356 CLASS="sect1"
2357 ><A
2358 NAME="HDRWQ74"
2359 >Protecting Group-Related Information</A
2360 ></H1
2361 ><P
2362 >A group's <SPAN
2363 CLASS="emphasis"
2364 ><I
2365 CLASS="emphasis"
2366 >privacy flags</I
2367 ></SPAN
2368 > control who can administer it in various ways. The privacy flags appear in
2369     the <SAMP
2370 CLASS="computeroutput"
2371 >flags</SAMP
2372 > field of the output from the <SPAN
2373 CLASS="bold"
2374 ><B
2375 CLASS="emphasis"
2376 >pts examine</B
2377 ></SPAN
2378 > command
2379     command; see <A
2380 HREF="c2454.html#HDRWQ67"
2381 >To Display A Group Entry</A
2382 >. To set the privacy flags for a group you own, use the
2383     <SPAN
2384 CLASS="bold"
2385 ><B
2386 CLASS="emphasis"
2387 >pts setfields</B
2388 ></SPAN
2389 > command as instructed in <A
2390 HREF="c2454.html#HDRWQ75"
2391 >To Set a Group's Privacy
2392     Flags</A
2393 >.</P
2394 ><DIV
2395 CLASS="sect2"
2396 ><H2
2397 CLASS="sect2"
2398 ><A
2399 NAME="HDRPRIVACY-FLAGS"
2400 >Interpreting the Privacy Flags</A
2401 ></H2
2402 ><P
2403 >The five privacy flags always appear, and always must be set, in the following order:</P
2404 ><DIV
2405 CLASS="variablelist"
2406 ><DL
2407 ><DT
2408 ><SPAN
2409 CLASS="bold"
2410 ><B
2411 CLASS="emphasis"
2412 >s</B
2413 ></SPAN
2414 ></DT
2415 ><DD
2416 ><P
2417 >Controls who can issue the <SPAN
2418 CLASS="bold"
2419 ><B
2420 CLASS="emphasis"
2421 >pts examine</B
2422 ></SPAN
2423 > command to display the entry.</P
2424 ></DD
2425 ><DT
2426 ><SPAN
2427 CLASS="bold"
2428 ><B
2429 CLASS="emphasis"
2430 >o</B
2431 ></SPAN
2432 ></DT
2433 ><DD
2434 ><P
2435 >Controls who can issue the <SPAN
2436 CLASS="bold"
2437 ><B
2438 CLASS="emphasis"
2439 >pts listowned</B
2440 ></SPAN
2441 > command to list the groups that a user
2442             or group owns.</P
2443 ></DD
2444 ><DT
2445 ><SPAN
2446 CLASS="bold"
2447 ><B
2448 CLASS="emphasis"
2449 >m</B
2450 ></SPAN
2451 ></DT
2452 ><DD
2453 ><P
2454 >Controls who can issue the <SPAN
2455 CLASS="bold"
2456 ><B
2457 CLASS="emphasis"
2458 >pts membership</B
2459 ></SPAN
2460 > command to list the groups a user or
2461             machine belongs to, or which users or machines belong to a group.</P
2462 ></DD
2463 ><DT
2464 ><SPAN
2465 CLASS="bold"
2466 ><B
2467 CLASS="emphasis"
2468 >a</B
2469 ></SPAN
2470 ></DT
2471 ><DD
2472 ><P
2473 >Controls who can issue the <SPAN
2474 CLASS="bold"
2475 ><B
2476 CLASS="emphasis"
2477 >pts adduser</B
2478 ></SPAN
2479 > command to add a user or machine to a
2480             group.</P
2481 ></DD
2482 ><DT
2483 ><SPAN
2484 CLASS="bold"
2485 ><B
2486 CLASS="emphasis"
2487 >r</B
2488 ></SPAN
2489 ></DT
2490 ><DD
2491 ><P
2492 >Controls who can issue the <SPAN
2493 CLASS="bold"
2494 ><B
2495 CLASS="emphasis"
2496 >pts removeuser</B
2497 ></SPAN
2498 > command to remove a user or machine
2499             from a group.</P
2500 ></DD
2501 ></DL
2502 ></DIV
2503 ><P
2504 >Each flag can take three possible types of values to enable a different set of users to issue the corresponding
2505       command:</P
2506 ><UL
2507 ><LI
2508 ><P
2509 >A hyphen (<SPAN
2510 CLASS="bold"
2511 ><B
2512 CLASS="emphasis"
2513 >-</B
2514 ></SPAN
2515 >) means that the group's owner can issue the command, along with the
2516           administrators who belong to the <SPAN
2517 CLASS="bold"
2518 ><B
2519 CLASS="emphasis"
2520 >system:administrators</B
2521 ></SPAN
2522 > group.</P
2523 ></LI
2524 ><LI
2525 ><P
2526 >The lowercase version of the letter means that members of the group can issue the command, along with the users
2527           indicated by the hyphen.</P
2528 ></LI
2529 ><LI
2530 ><P
2531 >The uppercase version of the letter means that anyone can issue the command.</P
2532 ></LI
2533 ></UL
2534 ><P
2535 >For example, the flags <SAMP
2536 CLASS="computeroutput"
2537 >SOmar</SAMP
2538 > on a group entry indicate that anyone can examine the
2539       group's entry and list the groups that it owns, and that only the group's members can list, add, or remove its members.</P
2540 ><P
2541 >The default privacy flags for groups are <SAMP
2542 CLASS="computeroutput"
2543 >S-M--</SAMP
2544 >, meaning that anyone can display the
2545       entry and list the members of the group, but only the group's owner and members of the <SPAN
2546 CLASS="bold"
2547 ><B
2548 CLASS="emphasis"
2549 >system:administrators</B
2550 ></SPAN
2551 > group can perform other functions.</P
2552 ></DIV
2553 ><DIV
2554 CLASS="sect2"
2555 ><H2
2556 CLASS="sect2"
2557 ><A
2558 NAME="HDRWQ75"
2559 >To Set a Group's Privacy Flags</A
2560 ></H2
2561 ><P
2562 >Issue the <SPAN
2563 CLASS="bold"
2564 ><B
2565 CLASS="emphasis"
2566 >pts setfields</B
2567 ></SPAN
2568 > command to set the privacy flags on one or more groups.</P
2569 ><PRE
2570 CLASS="programlisting"
2571 >&#13;   % <SPAN
2572 CLASS="bold"
2573 ><B
2574 CLASS="emphasis"
2575 >pts setfields -nameorid</B
2576 ></SPAN
2577 > &#60;<VAR
2578 CLASS="replaceable"
2579 >user or group name or id</VAR
2580 >&#62;<SUP
2581 >+</SUP
2582 >
2583                    <SPAN
2584 CLASS="bold"
2585 ><B
2586 CLASS="emphasis"
2587 >-access</B
2588 ></SPAN
2589 > &#60;<VAR
2590 CLASS="replaceable"
2591 >set privacy flags</VAR
2592 >&#62;
2593 </PRE
2594 ><P
2595 >where</P
2596 ><DIV
2597 CLASS="variablelist"
2598 ><DL
2599 ><DT
2600 ><SPAN
2601 CLASS="bold"
2602 ><B
2603 CLASS="emphasis"
2604 >-nameorid</B
2605 ></SPAN
2606 ></DT
2607 ><DD
2608 ><P
2609 >Specifies the name or AFS GID of each group for which to set the privacy flags. If identifying a group by its AFS
2610             GID, precede the GID with a hyphen (<SPAN
2611 CLASS="bold"
2612 ><B
2613 CLASS="emphasis"
2614 >-</B
2615 ></SPAN
2616 >) to indicate that it is a negative number.</P
2617 ></DD
2618 ><DT
2619 ><SPAN
2620 CLASS="bold"
2621 ><B
2622 CLASS="emphasis"
2623 >-access</B
2624 ></SPAN
2625 ></DT
2626 ><DD
2627 ><P
2628 >Specifies the privacy flags to set for each group. Observe the following rules:</P
2629 ><UL
2630 ><LI
2631 ><P
2632 >Provide a value for all five flags in the order <SPAN
2633 CLASS="bold"
2634 ><B
2635 CLASS="emphasis"
2636 >somar</B
2637 ></SPAN
2638 >.</P
2639 ></LI
2640 ><LI
2641 ><P
2642 >Set the first flag to lowercase <SPAN
2643 CLASS="bold"
2644 ><B
2645 CLASS="emphasis"
2646 >s</B
2647 ></SPAN
2648 > or uppercase <SPAN
2649 CLASS="bold"
2650 ><B
2651 CLASS="emphasis"
2652 >S</B
2653 ></SPAN
2654 > only.</P
2655 ></LI
2656 ><LI
2657 ><P
2658 >Set the second flag to the hyphen (<SPAN
2659 CLASS="bold"
2660 ><B
2661 CLASS="emphasis"
2662 >-</B
2663 ></SPAN
2664 >) or uppercase <SPAN
2665 CLASS="bold"
2666 ><B
2667 CLASS="emphasis"
2668 >O</B
2669 ></SPAN
2670 > only. For groups, AFS interprets the hyphen as equivalent to lowercase <SPAN
2671 CLASS="bold"
2672 ><B
2673 CLASS="emphasis"
2674 >o</B
2675 ></SPAN
2676 > (that is, members of a group can always list the groups that it owns).</P
2677 ></LI
2678 ><LI
2679 ><P
2680 >Set the third flag to the hyphen (<SPAN
2681 CLASS="bold"
2682 ><B
2683 CLASS="emphasis"
2684 >-</B
2685 ></SPAN
2686 >), lowercase <SPAN
2687 CLASS="bold"
2688 ><B
2689 CLASS="emphasis"
2690 >m</B
2691 ></SPAN
2692 >, or uppercase <SPAN
2693 CLASS="bold"
2694 ><B
2695 CLASS="emphasis"
2696 >M</B
2697 ></SPAN
2698 >.</P
2699 ></LI
2700 ><LI
2701 ><P
2702 >Set the fourth flag to the hyphen (<SPAN
2703 CLASS="bold"
2704 ><B
2705 CLASS="emphasis"
2706 >-</B
2707 ></SPAN
2708 >), lowercase <SPAN
2709 CLASS="bold"
2710 ><B
2711 CLASS="emphasis"
2712 >a</B
2713 ></SPAN
2714 >, or uppercase <SPAN
2715 CLASS="bold"
2716 ><B
2717 CLASS="emphasis"
2718 >A</B
2719 ></SPAN
2720 >. The uppercase <SPAN
2721 CLASS="bold"
2722 ><B
2723 CLASS="emphasis"
2724 >A</B
2725 ></SPAN
2726 > is not a secure choice, because it permits anyone to add members to the group.</P
2727 ></LI
2728 ><LI
2729 ><P
2730 >Set the fifth flag to the hyphen (<SPAN
2731 CLASS="bold"
2732 ><B
2733 CLASS="emphasis"
2734 >-</B
2735 ></SPAN
2736 >) or lowercase <SPAN
2737 CLASS="bold"
2738 ><B
2739 CLASS="emphasis"
2740 >r</B
2741 ></SPAN
2742 > only.</P
2743 ></LI
2744 ></UL
2745 ></DD
2746 ></DL
2747 ></DIV
2748 ></DIV
2749 ><DIV
2750 CLASS="sect2"
2751 ><H2
2752 CLASS="sect2"
2753 ><A
2754 NAME="Header_150"
2755 >Example: Setting a Group's Privacy Flags</A
2756 ></H2
2757 ><P
2758 >The following example sets the privacy flags on the <SPAN
2759 CLASS="bold"
2760 ><B
2761 CLASS="emphasis"
2762 >terry:team</B
2763 ></SPAN
2764 > group to set the
2765       indicated pattern of administrative privilege.</P
2766 ><PRE
2767 CLASS="programlisting"
2768 >&#13;   % <SPAN
2769 CLASS="bold"
2770 ><B
2771 CLASS="emphasis"
2772 >pts setfields terry:team -access SOm--</B
2773 ></SPAN
2774 >
2775   
2776 </PRE
2777 ><UL
2778 ><LI
2779 ><P
2780 >Everyone can issue the <SPAN
2781 CLASS="bold"
2782 ><B
2783 CLASS="emphasis"
2784 >pts examine</B
2785 ></SPAN
2786 > command to display general information about it
2787           (uppercase <SPAN
2788 CLASS="bold"
2789 ><B
2790 CLASS="emphasis"
2791 >S</B
2792 ></SPAN
2793 >).</P
2794 ></LI
2795 ><LI
2796 ><P
2797 >Everyone can issue the <SPAN
2798 CLASS="bold"
2799 ><B
2800 CLASS="emphasis"
2801 >pts listowned</B
2802 ></SPAN
2803 > command to display the groups it owns
2804           (uppercase <SPAN
2805 CLASS="bold"
2806 ><B
2807 CLASS="emphasis"
2808 >O</B
2809 ></SPAN
2810 >).</P
2811 ></LI
2812 ><LI
2813 ><P
2814 >The members of the group can issue the <SPAN
2815 CLASS="bold"
2816 ><B
2817 CLASS="emphasis"
2818 >pts membership</B
2819 ></SPAN
2820 > command to display the
2821           group's members (lowercase <SPAN
2822 CLASS="bold"
2823 ><B
2824 CLASS="emphasis"
2825 >m</B
2826 ></SPAN
2827 >).</P
2828 ></LI
2829 ><LI
2830 ><P
2831 >Only the group's owner, user <SPAN
2832 CLASS="bold"
2833 ><B
2834 CLASS="emphasis"
2835 >terry</B
2836 ></SPAN
2837 >, can issue the <SPAN
2838 CLASS="bold"
2839 ><B
2840 CLASS="emphasis"
2841 >pts
2842           adduser</B
2843 ></SPAN
2844 > command to add members (the hyphen).</P
2845 ></LI
2846 ><LI
2847 ><P
2848 >Only the group's owner, user <SPAN
2849 CLASS="bold"
2850 ><B
2851 CLASS="emphasis"
2852 >terry</B
2853 ></SPAN
2854 >, can issue the <SPAN
2855 CLASS="bold"
2856 ><B
2857 CLASS="emphasis"
2858 >pts
2859           removeuser</B
2860 ></SPAN
2861 > command to remove members (the hyphen).</P
2862 ></LI
2863 ></UL
2864 ></DIV
2865 ></DIV
2866 ></DIV
2867 ><DIV
2868 CLASS="NAVFOOTER"
2869 ><HR
2870 ALIGN="LEFT"
2871 WIDTH="100%"><TABLE
2872 SUMMARY="Footer navigation table"
2873 WIDTH="100%"
2874 BORDER="0"
2875 CELLPADDING="0"
2876 CELLSPACING="0"
2877 ><TR
2878 ><TD
2879 WIDTH="33%"
2880 ALIGN="left"
2881 VALIGN="top"
2882 ><A
2883 HREF="c1444.html"
2884 ACCESSKEY="P"
2885 >Prev</A
2886 ></TD
2887 ><TD
2888 WIDTH="34%"
2889 ALIGN="center"
2890 VALIGN="top"
2891 ><A
2892 HREF="book1.html"
2893 ACCESSKEY="H"
2894 >Home</A
2895 ></TD
2896 ><TD
2897 WIDTH="33%"
2898 ALIGN="right"
2899 VALIGN="top"
2900 ><A
2901 HREF="c3402.html"
2902 ACCESSKEY="N"
2903 >Next</A
2904 ></TD
2905 ></TR
2906 ><TR
2907 ><TD
2908 WIDTH="33%"
2909 ALIGN="left"
2910 VALIGN="top"
2911 >Protecting Your Directories and Files</TD
2912 ><TD
2913 WIDTH="34%"
2914 ALIGN="center"
2915 VALIGN="top"
2916 >&nbsp;</TD
2917 ><TD
2918 WIDTH="33%"
2919 ALIGN="right"
2920 VALIGN="top"
2921 >Troubleshooting</TD
2922 ></TR
2923 ></TABLE
2924 ></DIV
2925 ></BODY
2926 ></HTML
2927 >