1: # The LearningOnline Network with CAPA
2: # User Roles Screen
3: #
4: # $Id: lonroles.pm,v 1.183 2008/01/30 01:18:58 www Exp $
5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
28: ###
29:
30: package Apache::lonroles;
31:
32: use strict;
33: use Apache::lonnet;
34: use Apache::lonuserstate();
35: use Apache::Constants qw(:common);
36: use Apache::File();
37: use Apache::lonmenu;
38: use Apache::loncommon;
39: use Apache::lonhtmlcommon;
40: use Apache::lonannounce;
41: use Apache::lonlocal;
42: use Apache::lonpageflip();
43: use Apache::lonnavdisplay();
44: use GDBM_File;
45: use LONCAPA qw(:DEFAULT :match);
46:
47:
48: sub redirect_user {
49: my ($r,$title,$url,$msg,$launch_nav) = @_;
50: $msg = $title if (! defined($msg));
51: &Apache::loncommon::content_type($r,'text/html');
52: &Apache::loncommon::no_cache($r);
53: $r->send_http_header;
54: my $swinfo=&Apache::lonmenu::rawconfig();
55: my $navwindow;
56: if ($launch_nav eq 'on') {
57: $navwindow.=&Apache::lonnavdisplay::launch_win('now',undef,undef,
58: ($url =~ m-^/adm/whatsnew-));
59: } else {
60: $navwindow.=&Apache::lonnavmaps::close();
61: }
62: my $start_page = &Apache::loncommon::start_page('Switching Role',undef,
63: {'redirect' => [1,$url],});
64: my $end_page = &Apache::loncommon::end_page();
65:
66: # Note to style police:
67: # This must only replace the spaces, nothing else, or it bombs elsewhere.
68: $url=~s/ /\%20/g;
69: $r->print(<<ENDREDIR);
70: $start_page
71: <script type="text/javascript">
72: $swinfo
73: </script>
74: $navwindow
75: <h1>$msg</h1>
76: $end_page
77: ENDREDIR
78: return;
79: }
80:
81: sub error_page {
82: my ($r,$error,$dest)=@_;
83: &Apache::loncommon::content_type($r,'text/html');
84: &Apache::loncommon::no_cache($r);
85: $r->send_http_header;
86: return OK if $r->header_only;
87: $r->print(&Apache::loncommon::start_page('Problems during Course Initialization').
88: '<script type="text/javascript">'.
89: &Apache::lonmenu::rawconfig().'</script>'.
90: '<p>'.&mt('The following problems occurred:').
91: $error.
92: '</p><br /><a href="'.$dest.'">'.&mt('Continue').'</a>'.
93: &Apache::loncommon::end_page());
94: }
95:
96: sub handler {
97:
98: my $r = shift;
99:
100: my $now=time;
101: my $then=$env{'user.login.time'};
102: my $envkey;
103: my %dcroles = ();
104: my $numdc = &check_fordc(\%dcroles,$then);
105: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'});
106:
107: # ================================================================== Roles Init
108: if ($env{'form.selectrole'}) {
109: if ($env{'form.newrole'}) {
110: $env{'form.'.$env{'form.newrole'}}=1;
111: }
112: if ($env{'request.course.id'}) {
113: my %temp=('logout_'.$env{'request.course.id'} => time);
114: &Apache::lonnet::put('email_status',\%temp);
115: &Apache::lonnet::delenv('user.state.'.$env{'request.course.id'});
116: }
117: &Apache::lonnet::appenv("request.course.id" => '',
118: "request.course.fn" => '',
119: "request.course.uri" => '',
120: "request.course.sec" => '',
121: "request.role" => 'cm',
122: "request.role.adv" => $env{'user.adv'},
123: "request.role.domain" => $env{'user.domain'});
124:
125: # Check if user is a DC trying to enter a course or author space and needs privs to be created
126: if ($numdc > 0) {
127: foreach my $envkey (keys %env) {
128: # Is this an ad-hoc CC-role?
129: if (my ($domain,$coursenum) =
130: ($envkey =~ m-^form\.cc\./($match_domain)/($match_courseid)$-)) {
131: if ($dcroles{$domain}) {
132: &check_privs($domain,$coursenum,$then,$now,'cc');
133: }
134: last;
135: }
136: # Is this a recent ad-hoc CA-role?
137: if (my ($domain,$user) =
138: ($envkey =~ m-^form\.ca\./($match_domain)/($match_username)$-)) {
139: if (($dcroles{$domain}) && (&is_author_homeserver($user,$domain))) {
140: &check_privs($domain,$user,$then,$now,'ca');
141: } else {
142: delete($env{$envkey});
143: }
144: last;
145: }
146: # Is this a new ad-hoc CA-role?
147: if (my ($domain) =
148: ($envkey =~ m-^form\.adhocca\./($match_domain)$-)) {
149: if ($dcroles{$domain}) {
150: my $user=$env{'form.adhoccauname.'.$domain};
151: if (!$user) { $user=$env{'form.adhoccaunamerecent.'.$domain} };
152: if (($user) && ($user=~/$match_username/) && (&is_author_homeserver($user,$domain))) {
153: &check_privs($domain,$user,$then,$now,'ca');
154: $env{'form.ca./'.$domain.'/'.$user}=1;
155: }
156: }
157: last;
158: }
159: }
160: }
161:
162: foreach $envkey (keys %env) {
163: next if ($envkey!~/^user\.role\./);
164: my ($where,$trolecode,$role,$tstatus,$tend,$tstart);
165: &role_status($envkey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
166: if ($env{'form.'.$trolecode}) {
167: if ($tstatus eq 'is') {
168: $where=~s/^\///;
169: my ($cdom,$cnum,$csec)=split(/\//,$where);
170: # check for course groups
171: my %coursegroups = &Apache::lonnet::get_active_groups(
172: $env{'user.domain'},$env{'user.name'},$cdom, $cnum);
173: my $cgrps = join(':',keys(%coursegroups));
174:
175: # store role if recent_role list being kept
176: if ($env{'environment.recentroles'}) {
177: my %frozen_roles =
178: &Apache::lonhtmlcommon::get_recent_frozen('roles',$env{'environment.recentrolesn'});
179: &Apache::lonhtmlcommon::store_recent('roles',
180: $trolecode,' ',$frozen_roles{$trolecode});
181: }
182:
183:
184: # check for keyed access
185: if (($role eq 'st') &&
186: ($env{'course.'.$cdom.'_'.$cnum.'.keyaccess'} eq 'yes')) {
187: # who is key authority?
188: my $authdom=$cdom;
189: my $authnum=$cnum;
190: if ($env{'course.'.$cdom.'_'.$cnum.'.keyauth'}) {
191: ($authnum,$authdom)=
192: split(/:/,$env{'course.'.$cdom.'_'.$cnum.'.keyauth'});
193: }
194: # check with key authority
195: unless (&Apache::lonnet::validate_access_key(
196: $env{'environment.key.'.$cdom.'_'.$cnum},
197: $authdom,$authnum)) {
198: # there is no valid key
199: if ($env{'form.newkey'}) {
200: # student attempts to register a new key
201: &Apache::loncommon::content_type($r,'text/html');
202: &Apache::loncommon::no_cache($r);
203: $r->send_http_header;
204: my $swinfo=&Apache::lonmenu::rawconfig();
205: my $start_page=&Apache::loncommon::start_page
206: ('Verifying Access Key to Unlock this Course');
207: my $end_page=&Apache::loncommon::end_page();
208: my $buttontext=&mt('Enter Course');
209: my $message=&mt('Successfully registered key');
210: my $assignresult=
211: &Apache::lonnet::assign_access_key(
212: $env{'form.newkey'},
213: $authdom,$authnum,
214: $cdom,$cnum,
215: $env{'user.domain'},
216: $env{'user.name'},
217: 'Assigned from '.$ENV{'REMOTE_ADDR'}.' at '.localtime().' for '.
218: $trolecode);
219: unless ($assignresult eq 'ok') {
220: $assignresult=~s/^error\:\s*//;
221: $message=&mt($assignresult).
222: '<br /><a href="/adm/logout">'.
223: &mt('Logout').'</a>';
224: $buttontext=&mt('Re-Enter Key');
225: }
226: $r->print(<<ENDENTEREDKEY);
227: $start_page
228: <script type="text/javascript">
229: $swinfo
230: </script>
231: <form method="post">
232: <input type="hidden" name="selectrole" value="1" />
233: <input type="hidden" name="$trolecode" value="1" />
234: <font size="+2">$message</font><br />
235: <input type="submit" value="$buttontext" />
236: </form>
237: $end_page
238: ENDENTEREDKEY
239: return OK;
240: } else {
241: # print form to enter a new key
242: &Apache::loncommon::content_type($r,'text/html');
243: &Apache::loncommon::no_cache($r);
244: $r->send_http_header;
245: my $swinfo=&Apache::lonmenu::rawconfig();
246: my $start_page=&Apache::loncommon::start_page
247: ('Enter Access Key to Unlock this Course');
248: my $end_page=&Apache::loncommon::end_page();
249: $r->print(<<ENDENTERKEY);
250: $start_page
251: <script type="text/javascript">
252: $swinfo
253: </script>
254: <form method="post">
255: <input type="hidden" name="selectrole" value="1" />
256: <input type="hidden" name="$trolecode" value="1" />
257: <input type="text" size="20" name="newkey" value="$env{'form.newkey'}" />
258: <input type="submit" value="Enter key" />
259: </form>
260: $end_page
261: ENDENTERKEY
262: return OK;
263: }
264: }
265: }
266: &Apache::lonnet::log($env{'user.domain'},
267: $env{'user.name'},
268: $env{'user.home'},
269: "Role ".$trolecode);
270:
271: &Apache::lonnet::appenv(
272: 'request.role' => $trolecode,
273: 'request.role.domain' => $cdom,
274: 'request.course.sec' => $csec,
275: 'request.course.groups' => $cgrps);
276: my $tadv=0;
277:
278: if (($cnum) && ($role ne 'ca') && ($role ne 'aa')) {
279: my $msg;
280: my ($furl,$ferr)=
281: &Apache::lonuserstate::readmap($cdom.'/'.$cnum);
282: if (($env{'form.orgurl'}) &&
283: ($env{'form.orgurl'}!~/^\/adm\/flip/)) {
284: my $dest=$env{'form.orgurl'};
285: if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
286: &Apache::lonnet::appenv('request.role.adv'=>$tadv);
287: if (($ferr) && ($tadv)) {
288: &error_page($r,$ferr,$dest);
289: } else {
290: $r->internal_redirect($dest);
291: }
292: return OK;
293: } else {
294: if (!$env{'request.course.id'}) {
295: &Apache::lonnet::appenv(
296: "request.course.id" => $cdom.'_'.$cnum);
297: $furl='/adm/roles?tryagain=1';
298: $msg=
299: '<h1><span class="LC_error">'.
300: &mt('Could not initialize [_1] at this time.',
301: $env{'course.'.$cdom.'_'.$cnum.'.description'}).
302: '</span></h1><h3>'.&mt('Please try again.').'</h3>'.$ferr;
303: }
304: if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
305: &Apache::lonnet::appenv('request.role.adv'=>$tadv);
306:
307: if (($ferr) && ($tadv)) {
308: &error_page($r,$ferr,$furl);
309: } else {
310: # Check to see if the user is a CC entering a course
311: # for the first time
312: my (undef, undef, $role, $courseid) = split(/\./, $envkey);
313: if (substr($courseid, 0, 1) eq '/') {
314: $courseid = substr($courseid, 1);
315: }
316: $courseid =~ s/\//_/;
317: if ($role eq 'cc' && $env{'course.' . $courseid .
318: '.course.helper.not.run'}) {
319: $furl = "/adm/helper/course.initialization.helper";
320: # Send the user to the course they selected
321: } elsif ($env{'request.course.id'}) {
322: if (&Apache::lonnet::allowed('whn',
323: $env{'request.course.id'})
324: || &Apache::lonnet::allowed('whn',
325: $env{'request.course.id'}.'/'
326: .$env{'request.course.sec'})
327: ) {
328: my $startpage = &courseloadpage($courseid);
329: unless ($startpage eq 'firstres') {
330: $msg = &mt('Entering [_1] ....',
331: $env{'course.'.$courseid.'.description'});
332: &redirect_user($r,&mt('New in course'),
333: '/adm/whatsnew?refpage=start',$msg,
334: $env{'environment.remotenavmap'});
335: return OK;
336: }
337: }
338: }
339: # Are we allowed to look at the first resource?
340: if ($furl !~ m|^/adm/|) {
341: # Guess not ...
342: $furl=&Apache::lonpageflip::first_accessible_resource();
343: }
344: $msg = &mt('Entering [_1] ...',
345: $env{'course.'.$courseid.'.description'});
346: &redirect_user($r,&mt('Entering [_1]',
347: $env{'course.'.$courseid.'.description'}),
348: $furl,$msg,
349: $env{'environment.remotenavmap'});
350: }
351: return OK;
352: }
353: }
354: #
355: # Send the user to the construction space they selected
356: if ($role =~ /^(au|ca|aa)$/) {
357: my $redirect_url = '/priv/';
358: if ($role eq 'au') {
359: $redirect_url.=$env{'user.name'};
360: } else {
361: $where =~ /\/(.*)$/;
362: $redirect_url .= $1;
363: }
364: $redirect_url .= '/';
365: &redirect_user($r,&mt('Entering Construction Space'),
366: $redirect_url);
367: return OK;
368: }
369: if ($role eq 'dc') {
370: my $redirect_url = '/adm/menu/';
371: &redirect_user($r,&mt('Loading Domain Coordinator Menu'),
372: $redirect_url);
373: return OK;
374: }
375: }
376: }
377: }
378: }
379:
380:
381: # =============================================================== No Roles Init
382:
383: &Apache::loncommon::content_type($r,'text/html');
384: &Apache::loncommon::no_cache($r);
385: $r->send_http_header;
386: return OK if $r->header_only;
387:
388: my $swinfo=&Apache::lonmenu::rawconfig();
389: my $start_page=&Apache::loncommon::start_page('User Roles');
390: my $standby=&mt('Role selected. Please stand by.');
391: $standby=~s/\n/\\n/g;
392: my $noscript='<span class="LC_error">'.&mt('Use of LON-CAPA requires Javascript to be enabled in your web browser.').'<br />'.&mt('As this is not the case, most functionality in the system will ba unavailable.').'</span><br />';
393:
394: $r->print(<<ENDHEADER);
395: $start_page
396: <br />
397: <noscript>
398: $noscript
399: </noscript>
400: <script type="text/javascript">
401: $swinfo
402: window.focus();
403:
404: active=true;
405:
406: function enterrole (thisform,rolecode,buttonname) {
407: if (active) {
408: active=false;
409: document.title='$standby';
410: window.status='$standby';
411: thisform.newrole.value=rolecode;
412: thisform.submit();
413: } else {
414: alert('$standby');
415: }
416: }
417: </script>
418: ENDHEADER
419:
420: # ------------------------------------------ Get Error Message from Environment
421:
422: my ($fn,$priv,$nochoose,$error,$msg)=split(/:/,$env{'user.error.msg'});
423: if ($env{'user.error.msg'}) {
424: $r->log_reason(
425: "$msg for $env{'user.name'} domain $env{'user.domain'} access $priv",$fn);
426: }
427:
428: # ------------------------------------------------- Can this user re-init, etc?
429:
430: my $advanced=$env{'user.adv'};
431: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['tryagain']);
432: my $tryagain=$env{'form.tryagain'};
433:
434: # -------------------------------------------------------- Generate Page Output
435: # --------------------------------------------------------------- Error Header?
436: if ($error) {
437: $r->print("<h1>LON-CAPA Access Control</h1>");
438: $r->print("<!-- LONCAPAACCESSCONTROLERRORSCREEN --><hr /><pre>");
439: if ($priv ne '') {
440: $r->print("Access : ".&Apache::lonnet::plaintext($priv)."\n");
441: }
442: if ($fn ne '') {
443: $r->print("Resource: ".&Apache::lonenc::check_encrypt($fn)."\n");
444: }
445: if ($msg ne '') {
446: $r->print("Action : $msg\n");
447: }
448: $r->print("</pre><hr />");
449: my $url=$fn;
450: my $last;
451: if (tie(my %hash,'GDBM_File',$env{'request.course.fn'}.'_symb.db',
452: &GDBM_READER(),0640)) {
453: $last=$hash{'last_known'};
454: untie(%hash);
455: }
456: if ($last) { $fn.='?symb='.&escape($last); }
457:
458: &Apache::londocs::changewarning($r,undef,'You have modified your course recently, [_1] may fix this access problem.',
459: &Apache::lonenc::check_encrypt($fn));
460: } else {
461: if ($env{'user.error.msg'}) {
462: $r->print(
463: '<h3><span class="LC_error">'.
464: &mt('You need to choose another user role or enter a specific course for this function').'</span></h3>');
465: }
466: }
467: # -------------------------------------------------------- Choice or no choice?
468: if ($nochoose) {
469: $r->print("<h2>".&mt('Sorry ...')."</h2>\n<span class='LC_error'>".
470: &mt('This action is currently not authorized.').'</span>'.
471: &Apache::loncommon::end_page());
472: return OK;
473: } else {
474: if (($ENV{'REDIRECT_QUERY_STRING'}) && ($fn)) {
475: $fn.='?'.$ENV{'REDIRECT_QUERY_STRING'};
476: }
477: $r->print('<form method="post" name="rolechoice" action="'.(($fn)?$fn:$r->uri).'">');
478: $r->print('<input type="hidden" name="orgurl" value="'.$fn.'" />');
479: $r->print('<input type="hidden" name="selectrole" value="1" />');
480: $r->print('<input type="hidden" name="newrole" value="" />');
481: }
482: if ($env{'user.adv'}) {
483: $r->print(
484: '<br /><span class="LC_rolesinfo"><label>'.&mt('Show all roles').': <input type="checkbox" name="showall"');
485: if ($env{'form.showall'}) { $r->print(' checked="checked" '); }
486: $r->print(' /></label><input type="submit" value="'.&mt('Display').'" /></span>');
487: }
488:
489: my (%roletext,%sortrole,%roleclass);
490: my $countactive=0;
491: my $inrole=0;
492: my $possiblerole='';
493: foreach $envkey (sort keys %env) {
494: my $button = 1;
495: my $switchserver='';
496: my $roletext;
497: my $sortkey;
498: if ($envkey=~/^user\.role\./) {
499: my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus,$tpstart,$tpend,$tfont);
500: &role_status($envkey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
501: next if (!defined($role) || $role eq '' || $role =~ /^gr/);
502: $tremark='';
503: $tpstart=' ';
504: $tpend=' ';
505: $tfont='#000000';
506: if ($tstart) {
507: $tpstart=&Apache::lonlocal::locallocaltime($tstart);
508: }
509: if ($tend) {
510: $tpend=&Apache::lonlocal::locallocaltime($tend);
511: }
512: if ($env{'request.role'} eq $trolecode) {
513: $tstatus='selected';
514: }
515: my $tbg;
516: if (($tstatus eq 'is')
517: || ($tstatus eq 'selected')
518: || ($tstatus eq 'will')
519: || ($tstatus eq 'future')
520: || ($env{'form.showall'})) {
521: if ($tstatus eq 'is') {
522: $tbg='#77FF77';
523: $tfont='#003300';
524: $possiblerole=$trolecode;
525: $countactive++;
526: } elsif ($tstatus eq 'future') {
527: $tbg='#FFFF77';
528: $button=0;
529: } elsif ($tstatus eq 'will') {
530: $tbg='#FFAA77';
531: $tremark.=&mt('Active at next login. ');
532: } elsif ($tstatus eq 'expired') {
533: $tbg='#FF7777';
534: $tfont='#330000';
535: $button=0;
536: } elsif ($tstatus eq 'will_not') {
537: $tbg='#AAFF77';
538: $tremark.=&mt('Expired after logout. ');
539: } elsif ($tstatus eq 'selected') {
540: $tbg='#11CC55';
541: $tfont='#002200';
542: $inrole=1;
543: $countactive++;
544: $tremark.=&mt('Currently selected. ');
545: }
546: my $trole;
547: if ($role =~ /^cr\//) {
548: my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$role);
549: if ($tremark) { $tremark.='<br />'; }
550: $tremark.=&mt('Defined by ').$rauthor.
551: &mt(' at ').$rdomain.'.';
552: }
553: $trole=Apache::lonnet::plaintext($role);
554: my $ttype;
555: my $twhere;
556: my ($tdom,$trest,$tsection)=
557: split(/\//,Apache::lonnet::declutter($where));
558: # First, Co-Authorship roles
559: if (($role eq 'ca') || ($role eq 'aa')) {
560: my $home = &Apache::lonnet::homeserver($trest,$tdom);
561: my $allowed=0;
562: my @ids=&Apache::lonnet::current_machine_ids();
563: foreach my $id (@ids) { if ($id eq $home) { $allowed=1; } }
564: if (!$allowed) {
565: $button=0;
566: $switchserver='otherserver='.$home.'&role='.$trolecode;
567: }
568: #next if ($home eq 'no_host');
569: $home = &Apache::lonnet::hostname($home);
570: $ttype='Construction Space';
571: $twhere=&mt('User').': '.$trest.'<br />'.&mt('Domain').
572: ': '.$tdom.'<br />'.
573: ' '.&mt('Server').': '.$home;
574: $env{'course.'.$tdom.'_'.$trest.'.description'}='ca';
575: $tremark.=&Apache::lonhtmlcommon::authorbombs('/res/'.$tdom.'/'.$trest.'/');
576: $sortkey=$role."$trest:$tdom";
577: } elsif ($role eq 'au') {
578: # Authors
579: my $home = &Apache::lonnet::homeserver
580: ($env{'user.name'},$env{'user.domain'});
581: my $allowed=0;
582: my @ids=&Apache::lonnet::current_machine_ids();
583: foreach my $id (@ids) { if ($id eq $home) { $allowed=1; } }
584: if (!$allowed) {
585: $button=0;
586: $switchserver='otherserver='.$home.'&role='.$trolecode;
587: }
588: #next if ($home eq 'no_host');
589: $home = &Apache::lonnet::hostname($home);
590: $ttype='Construction Space';
591: $twhere=&mt('Domain').': '.$tdom.'<br />'.&mt('Server').
592: ': '.$home;
593: $env{'course.'.$tdom.'_'.$trest.'.description'}='ca';
594: $tremark.=&Apache::lonhtmlcommon::authorbombs('/res/'.$tdom.'/'.$env{'user.name'}.'/');
595: $sortkey=$role;
596: } elsif ($trest) {
597: my $tcourseid=$tdom.'_'.$trest;
598: $ttype = &Apache::loncommon::course_type($tcourseid);
599: $trole = &Apache::lonnet::plaintext($role,$ttype);
600: if ($env{'course.'.$tcourseid.'.description'}) {
601: $twhere=$env{'course.'.$tcourseid.'.description'};
602: $sortkey=$role."\0".$tdom."\0".$twhere."\0".$envkey;
603: unless ($twhere eq &mt('Currently not available')) {
604: $twhere.=' <font size="-2">'.
605: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom,$tfont).
606: '</font>';
607: }
608: } else {
609: my %newhash=&Apache::lonnet::coursedescription($tcourseid);
610: if (%newhash) {
611: $sortkey=$role."\0".$tdom."\0".$newhash{'description'}.
612: "\0".$envkey;
613: $twhere=$newhash{'description'}.
614: ' <font size="-2">'.
615: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom,$tfont).
616: '</font>';
617: $ttype = $newhash{'type'};
618: $trole = &Apache::lonnet::plaintext($role,$ttype);
619: } else {
620: $twhere=&mt('Currently not available');
621: $env{'course.'.$tcourseid.'.description'}=$twhere;
622: $sortkey=$role."\0".$tdom."\0".$twhere."\0".$envkey;
623: $ttype = 'Unavailable';
624: }
625: }
626: if ($tsection) {
627: $twhere.='<br />'.&mt('Section').': '.$tsection;
628: }
629: if ($role ne 'st') { $twhere.="<br />".&mt('Domain').":".$tdom; }
630: } elsif ($tdom) {
631: $ttype='Domain';
632: $twhere=$tdom;
633: $sortkey=$role.$twhere;
634: } else {
635: $ttype='System';
636: $twhere=&mt('system wide');
637: $sortkey=$role.$twhere;
638: }
639: $roletext.=&build_roletext($trolecode,$tdom,$trest,$tstatus,$tryagain,$advanced,$tremark,$tbg,$tfont,$trole,$twhere,$tpstart,$tpend,$nochoose,$button,$switchserver);
640: $roletext{$envkey}=$roletext;
641: if (!$sortkey) {$sortkey=$twhere."\0".$envkey;}
642: $sortrole{$sortkey}=$envkey;
643: $roleclass{$envkey}=$ttype;
644: }
645: }
646: }
647: # No active roles
648: if ($countactive==0) {
649: if ($inrole) {
650: $r->print('<h2>'.&mt('Currently no additional roles or courses').'</h2>');
651: } else {
652: $r->print('<h2>'.&mt('Currently no active roles or courses').'</h2>');
653: }
654: $r->print('</form>'.&Apache::loncommon::end_page());
655: return OK;
656: # Is there only one choice?
657: } elsif (($countactive==1) && ($env{'request.role'} eq 'cm')) {
658: $r->print('<h3>'.&mt('Please stand by.').'</h3>'.
659: '<input type="hidden" name="'.$possiblerole.'" value="1" />'.
660: '<noscript><br /><input type="submit" name="submit" value="'.&mt('Continue').'" /></noscript>');
661: $r->print("</form>\n");
662: $r->rflush();
663: $r->print('<script type="text/javascript">document.forms.rolechoice.submit();</script>');
664: $r->print(&Apache::loncommon::end_page());
665: return OK;
666: }
667: # More than one possible role
668: # ----------------------------------------------------------------------- Table
669: unless ((!&Apache::lonmenu::show_course()) || ($nochoose)) {
670: $r->print("<h2>".&mt('Select a Course to Enter')."</h2>\n");
671: }
672: $r->print('<br /><table id="LC_rolesmenu"><tr>');
673: unless ($nochoose) { $r->print('<th> </th>'); }
674: $r->print('<th>'.&mt('User Role').'</th><th>'.&mt('Extent').
675: '</th><th>'.&mt('Start').'</th><th>'.&mt('End').'</th></tr>'."\n");
676: my $doheaders=-1;
677: foreach my $type ('Domain','Construction Space','Course','Unavailable','System') {
678: my $haverole=0;
679: foreach my $which (sort {uc($a) cmp uc($b)} (keys(%sortrole))) {
680: if ($roleclass{$sortrole{$which}} =~ /^\Q$type\E/) {
681: $haverole=1;
682: }
683: }
684: if ($haverole) { $doheaders++; }
685: }
686:
687: if ($env{'environment.recentroles'}) {
688: my %recent_roles =
689: &Apache::lonhtmlcommon::get_recent('roles',$env{'environment.recentrolesn'});
690: my $output='';
691: foreach (sort(keys(%recent_roles))) {
692: if (defined($roletext{'user.role.'.$_})) {
693: $output.=$roletext{'user.role.'.$_};
694: if ($_ =~ m-dc\./($match_domain)/-
695: && $dcroles{$1}) {
696: $output .= &allcourses_row($1,'recent').
697: &allcoauthors_row($1,'recent');
698: }
699: } elsif ($numdc > 0) {
700: unless ($_ =~/^error\:/) {
701: $output.=&display_cc_role('user.role.'.$_);
702: }
703: }
704: }
705: if ($output) {
706: $r->print("<tr><td align='center' colspan='5'><font face='arial'>".
707: &mt('Recent Roles')."</font></td>");
708: $r->print($output);
709: $r->print("</tr>");
710: $doheaders ++;
711: }
712: }
713:
714: if ($numdc > 0) {
715: $r->print(&coursepick_jscript());
716: $r->print(&Apache::loncommon::coursebrowser_javascript());
717: }
718: foreach my $type ('Construction Space','Domain','Course','Unavailable','System') {
719: my $output;
720: foreach my $which (sort {uc($a) cmp uc($b)} (keys(%sortrole))) {
721: if ($roleclass{$sortrole{$which}} =~ /^\Q$type\E/) {
722: $output.=$roletext{$sortrole{$which}};
723: if ($sortrole{$which} =~ m-dc\./($match_domain)/-) {
724: if ($dcroles{$1}) {
725: $output .= &allcourses_row($1,'').
726: &allcoauthors_row($1,'');
727: }
728: }
729: }
730: }
731: if ($output) {
732: if ($doheaders > 0) {
733: $r->print("<tr>".
734: "<td align='center' colspan='5'><font face='arial'>".&mt($type)."</font></td></tr>");
735: }
736: $r->print($output);
737: }
738: }
739: my $tremark='';
740: my $tfont='#003300';
741: if ($env{'request.role'} eq 'cm') {
742: $r->print('<tr bgcolor="#11CC55">');
743: $tremark=&mt('Currently selected. ');
744: $tfont='#002200';
745: } else {
746: $r->print('<tr bgcolor="#77FF77">');
747: }
748: unless ($nochoose) {
749: if ($env{'request.role'} ne 'cm') {
750: $r->print('<td><input type="submit" value="'.
751: &mt('Select').'" name="cm"></td>');
752: } else {
753: $r->print('<td> </td>');
754: }
755: }
756: $r->print('<td colspan="3"><font color="'.$tfont.'"><span class="LC_rolesinfo">'.&mt('No role specified').
757: '</font></span></td><td><font color="'.$tfont.'">'.$tremark.
758: ' </font></td></tr>'."\n");
759:
760: $r->print('</table>');
761: unless ($nochoose) {
762: $r->print("</form>\n");
763: }
764: # ------------------------------------------------------------ Privileges Info
765: if (($advanced) && (($env{'user.error.msg'}) || ($error))) {
766: $r->print('<hr /><h2>Current Privileges</h2>');
767: $r->print(&privileges_info());
768: }
769: $r->print(&Apache::lonnet::getannounce());
770: if ($advanced) {
771: $r->print('<p><small><i>This is LON-CAPA '.
772: $r->dir_config('lonVersion').'</i><br />'.
773: '<a href="/adm/logout">'.&mt('Logout').'</a></small></p>');
774: }
775: $r->print(&Apache::loncommon::end_page());
776: return OK;
777: }
778:
779: sub privileges_info {
780: my ($which) = @_;
781: my $output;
782:
783: $which ||= $env{'request.role'};
784:
785: foreach my $envkey (sort(keys(%env))) {
786: next if ($envkey!~/^user\.priv\.\Q$which\E\.(.*)/);
787:
788: my $where=$1;
789: my $ttype;
790: my $twhere;
791: my (undef,$tdom,$trest,$tsec)=split(m{/},$where);
792: if ($trest) {
793: if ($env{'course.'.$tdom.'_'.$trest.'.description'} eq 'ca') {
794: $ttype='Construction Space';
795: $twhere='User: '.$trest.', Domain: '.$tdom;
796: } else {
797: $ttype= &Apache::loncommon::course_type($tdom.'_'.$trest);
798: $twhere=$env{'course.'.$tdom.'_'.$trest.'.description'};
799: if ($tsec) {
800: my $sec_type = 'Section';
801: if (exists($env{"user.role.gr.$where"})) {
802: $sec_type = 'Group';
803: }
804: $twhere.=' ('.$sec_type.': '.$tsec.')';
805: }
806: }
807: } elsif ($tdom) {
808: $ttype='Domain';
809: $twhere=$tdom;
810: } else {
811: $ttype='System';
812: $twhere='/';
813: }
814: $output .= "\n<h3>".$ttype.': '.$twhere.'</h3>'."\n<ul>";
815: foreach my $priv (sort(split(/:/,$env{$envkey}))) {
816: next if (!$priv);
817:
818: my ($prv,$restr)=split(/\&/,$priv);
819: my $trestr='';
820: if ($restr ne 'F') {
821: $trestr.=' ('.
822: join(', ',
823: map { &Apache::lonnet::plaintext($_) }
824: (split('',$restr))).') ';
825: }
826: $output .= "\n\t".
827: '<li>'.&Apache::lonnet::plaintext($prv).$trestr.'</li>';
828: }
829: $output .= "\n".'</ul>';
830: }
831: return $output;
832: }
833:
834: sub role_status {
835: my ($rolekey,$then,$now,$role,$where,$trolecode,$tstatus,$tstart,$tend) = @_;
836: my @pwhere = ();
837: if (exists($env{$rolekey}) && $env{$rolekey} ne '') {
838: (undef,undef,$$role,@pwhere)=split(/\./,$rolekey);
839: unless (!defined($$role) || $$role eq '') {
840: $$where=join('.',@pwhere);
841: $$trolecode=$$role.'.'.$$where;
842: ($$tstart,$$tend)=split(/\./,$env{$rolekey});
843: $$tstatus='is';
844: if ($$tstart && $$tstart>$then) {
845: $$tstatus='future';
846: if ($$tstart<$now) { $$tstatus='will'; }
847: }
848: if ($$tend) {
849: if ($$tend<$then) {
850: $$tstatus='expired';
851: } elsif ($$tend<$now) {
852: $$tstatus='will_not';
853: }
854: }
855: }
856: }
857: }
858:
859: sub build_roletext {
860: my ($trolecode,$tdom,$trest,$tstatus,$tryagain,$advanced,$tremark,$tbg,$tfont,$trole,$twhere,$tpstart,$tpend,$nochoose,$button,$switchserver) = @_;
861: my $roletext='<tr bgcolor="'.$tbg.'" class="LC_rolesmenu_'.$tstatus.'">';
862: my $is_dc=($trolecode =~ m/^dc\./);
863: my $rowspan=($is_dc) ? ''
864: : ' rowspan="2" ';
865:
866: unless ($nochoose) {
867: my $buttonname=$trolecode;
868: $buttonname=~s/\W//g;
869: if (!$button) {
870: if ($switchserver) {
871: $roletext.='<td'.$rowspan.'><span class="LC_rolesinfo"><a href="/adm/switchserver?'.
872: $switchserver.'">'.&mt('Switch Server').'</a></span></td>';
873: } else {
874: $roletext.=('<td'.$rowspan.'> </td>');
875: }
876: } elsif ($tstatus eq 'is') {
877: $roletext.='<td'.$rowspan.'><input name="'.$buttonname.'" type="button" value="'.
878: &mt('Select').'" onClick="javascript:enterrole(this.form,\''.
879: $trolecode."','".$buttonname.'\');"></td>';
880: } elsif ($tryagain) {
881: $roletext.=
882: '<td'.$rowspan.'><input name="'.$buttonname.'" type="button" value="'.
883: &mt('Try Selecting Again').'" onClick="javascript:enterrole(this.form,\''.
884: $trolecode."','".$buttonname.'\');"></td>';
885: } elsif ($advanced) {
886: $roletext.=
887: '<td'.$rowspan.'><input name="'.$buttonname.'" type="button" value="'.
888: &mt('Re-Initialize').'" onClick="javascript:enterrole(this.form,\''.
889: $trolecode."','".$buttonname.'\');"></td>';
890: } else {
891: $roletext.='<td'.$rowspan.'> </td>';
892: }
893: }
894: if ($trolecode !~ m/^(dc|ca|au|aa)\./) {
895: $tremark.=&Apache::lonannounce::showday(time,1,
896: &Apache::lonannounce::readcalendar($tdom.'_'.$trest));
897: }
898: $roletext.='<td><font color="'.$tfont.'">'.$trole.
899: '</font></td><td><font color="'.$tfont.'">'.$twhere.
900: '</font></td><td><font color="'.$tfont.'">'.$tpstart.
901: '</font></td><td><font color="'.$tfont.'">'.$tpend.
902: '</font></td></tr>';
903: if (!$is_dc) {
904: $roletext.='<tr bgcolor="'.$tbg.'"><td colspan="4"><font color="'.$tfont.'"><span class="LC_rolesinfo">'.$tremark.
905: '</span> </font></td></tr><tr><td colspan="5" height="3"></td></tr>'."\n";
906: }
907: return $roletext;
908: }
909:
910: sub is_author_homeserver {
911: my ($uname,$udom)=@_;
912: my $home = &Apache::lonnet::homeserver($uname,$udom);
913: my @ids=&Apache::lonnet::current_machine_ids();
914: foreach my $id (@ids) {
915: if ($id eq $home) {
916: if (-e "/home/".$uname."/public_html") {
917: return 1;
918: }
919: }
920: }
921: return 0;
922: }
923:
924: sub check_privs {
925: my ($cdom,$cnum,$then,$now,$checkrole) = @_;
926: my $cckey = 'user.role.'.$checkrole.'./'.$cdom.'/'.$cnum;
927: if ($env{$cckey}) {
928: my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus,$tpstart,$tpend,$tfont);
929: &role_status($cckey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
930: unless (($tstatus eq 'is') || ($tstatus eq 'will_not')) {
931: &set_privileges($cdom,$cnum,$checkrole);
932: }
933: } else {
934: &set_privileges($cdom,$cnum,$checkrole);
935: }
936: }
937:
938: sub check_fordc {
939: my ($dcroles,$then) = @_;
940: my $numdc = 0;
941: if ($env{'user.adv'}) {
942: foreach my $envkey (sort keys %env) {
943: if ($envkey=~/^user\.role\.dc\.\/($match_domain)\/$/) {
944: my $dcdom = $1;
945: my $livedc = 1;
946: my ($tstart,$tend)=split(/\./,$env{$envkey});
947: if ($tstart && $tstart>$then) { $livedc = 0; }
948: if ($tend && $tend <$then) { $livedc = 0; }
949: if ($livedc) {
950: $$dcroles{$dcdom} = $envkey;
951: $numdc++;
952: }
953: }
954: }
955: }
956: return $numdc;
957: }
958:
959: sub courselink {
960: my ($dcdom,$rowtype,$selecttype) = @_;
961: my $courseform=&Apache::loncommon::selectcourse_link
962: ('rolechoice','dccourse'.$rowtype.'_'.$dcdom,
963: 'dcdomain'.$rowtype.'_'.$dcdom,'coursedesc'.$rowtype.'_'.
964: $dcdom,$dcdom,undef);
965: my $hiddenitems = '<input type="hidden" name="dcdomain'.$rowtype.'_'.$dcdom.'" value="'.$dcdom.'" />'.
966: '<input type="hidden" name="origdom'.$rowtype.'_'.$dcdom.'" value="'.$dcdom.'" />'.
967: '<input type="hidden" name="dccourse'.$rowtype.'_'.$dcdom.'" value="" />'.
968: '<input type="hidden" name="coursedesc'.$rowtype.'_'.$dcdom.'" value="" />';
969: return $courseform.$hiddenitems;
970: }
971:
972: sub coursepick_jscript {
973: my $verify_script = <<"END";
974: <script type="text/javascript">
975: function verifyCoursePick(caller) {
976: var numbutton = getIndex(caller)
977: var pickedCourse = document.rolechoice.elements[numbutton+4].value
978: var pickedDomain = document.rolechoice.elements[numbutton+2].value
979: if (document.rolechoice.elements[numbutton+2].value == document.rolechoice.elements[numbutton+3].value) {
980: if (pickedCourse != '') {
981: if (numbutton != -1) {
982: var courseTarget = "cc./"+pickedDomain+"/"+pickedCourse
983: document.rolechoice.elements[numbutton+1].name = courseTarget
984: document.rolechoice.submit()
985: }
986: }
987: else {
988: alert("Please use the 'Select Course' link to open a separate pick course window where you may select the course you wish to enter.");
989: }
990: }
991: else {
992: alert("You can only use this screen to select courses in the current domain")
993: }
994: }
995: function getIndex(caller) {
996: for (var i=0;i<document.rolechoice.elements.length;i++) {
997: if (document.rolechoice.elements[i] == caller) {
998: return i;
999: }
1000: }
1001: return -1;
1002: }
1003: </script>
1004: END
1005: return $verify_script;
1006: }
1007:
1008: sub display_cc_role {
1009: my $rolekey = shift;
1010: my $roletext;
1011: my $advanced = $env{'user.adv'};
1012: my $tryagain = $env{'form.tryagain'};
1013: unless ($rolekey =~/^error\:/) {
1014: if ($rolekey =~ m-^user\.role.cc\./($match_domain)/($match_courseid)$-) {
1015: my $tcourseid = $1.'_'.$2;
1016: my $trolecode = 'cc./'.$1.'/'.$2;
1017: my $twhere;
1018: my $ttype;
1019: my $tbg='#77FF77';
1020: my $tfont='#003300';
1021: my %newhash=&Apache::lonnet::coursedescription($tcourseid);
1022: if (%newhash) {
1023: $twhere=$newhash{'description'}.
1024: ' <font size="-2">'.
1025: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$2,$1,$tfont).
1026: '</font>';
1027: $ttype = $newhash{'type'};
1028: } else {
1029: $twhere=&mt('Currently not available');
1030: $env{'course.'.$tcourseid.'.description'}=$twhere;
1031: }
1032: my $trole = &Apache::lonnet::plaintext('cc',$ttype);
1033: $twhere.="<br />".&mt('Domain').":".$1;
1034: $roletext = &build_roletext($trolecode,$1,$2,'is',$tryagain,$advanced,'',$tbg,$tfont,$trole,$twhere,'','','',1,'');
1035: }
1036: }
1037: return ($roletext);
1038: }
1039:
1040: sub allcourses_row {
1041: my ($dcdom,$rowtype) = @_;
1042: my $output = '<tr bgcolor="#77FF77">'.
1043: ' <td colspan="5">';
1044: my $selectlink = &courselink($dcdom,$rowtype);
1045: my $ccrole = &Apache::lonnet::plaintext('cc');
1046: $output.= '<span class="LC_rolesinfo">'.
1047: &mt('[_1]: [_2] from domain [_3]',$ccrole,$selectlink,$dcdom).
1048: '</span><br /></tr>'."\n";
1049: return $output;
1050: }
1051:
1052: sub allcoauthors_row {
1053: my ($dcdom,$rowtype) = @_;
1054: my $output = '<tr bgcolor="#77FF77">'.
1055: ' <td colspan="5">';
1056: my $carole = &Apache::lonnet::plaintext('ca');
1057: my $inputlink='<input type="text" size="10" name="adhoccauname'.$rowtype.'.'.$dcdom.'" />';
1058: my $gobutton='<input type="submit" name="adhocca./'.$dcdom.'" value="'.&mt('Go').'" />';
1059: $output.= '<span class="LC_rolesinfo">'.
1060: &mt('[_1]: [_2] in domain [_3] [_4]',$carole,$inputlink,$dcdom,$gobutton).
1061: '</span><br /></tr><tr><td colspan="5" height="3"></td></tr>'."\n";
1062: return $output;
1063: }
1064:
1065: sub recent_filename {
1066: my $area=shift;
1067: return 'nohist_recent_'.&escape($area);
1068: }
1069:
1070: sub set_privileges {
1071: # role can be cc or ca
1072: my ($dcdom,$pickedcourse,$role) = @_;
1073: my $area = '/'.$dcdom.'/'.$pickedcourse;
1074: my $spec = $role.'.'.$area;
1075: my %userroles = &Apache::lonnet::set_arearole($role,$area,'','',
1076: $env{'user.domain'},
1077: $env{'user.name'});
1078: my %ccrole = ();
1079: &Apache::lonnet::standard_roleprivs(\%ccrole,$role,$dcdom,$spec,$pickedcourse,$area);
1080: my ($author,$adv)= &Apache::lonnet::set_userprivs(\%userroles,\%ccrole);
1081: &Apache::lonnet::appenv(%userroles);
1082: &Apache::lonnet::log($env{'user.domain'},
1083: $env{'user.name'},
1084: $env{'user.home'},
1085: "Role ".$role);
1086: &Apache::lonnet::appenv(
1087: 'request.role' => $spec,
1088: 'request.role.domain' => $dcdom,
1089: 'request.course.sec' => '');
1090: my $tadv=0;
1091: if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
1092: &Apache::lonnet::appenv('request.role.adv' => $tadv);
1093: }
1094:
1095: sub courseloadpage {
1096: my ($courseid) = @_;
1097: my $startpage;
1098: my %entry_settings = &Apache::lonnet::get('nohist_whatsnew',
1099: [$courseid.':courseinit']);
1100: my ($tmp) = %entry_settings;
1101: unless ($tmp =~ /^error: 2 /) {
1102: $startpage = $entry_settings{$courseid.':courseinit'};
1103: }
1104: if ($startpage eq '') {
1105: if (exists($env{'environment.course_init_display'})) {
1106: $startpage = $env{'environment.course_init_display'};
1107: }
1108: }
1109: return $startpage;
1110: }
1111:
1112: 1;
1113: __END__
1114:
1115: =head1 NAME
1116:
1117: Apache::lonroles - User Roles Screen
1118:
1119: =head1 SYNOPSIS
1120:
1121: Invoked by /etc/httpd/conf/srm.conf:
1122:
1123: <Location /adm/roles>
1124: PerlAccessHandler Apache::lonacc
1125: SetHandler perl-script
1126: PerlHandler Apache::lonroles
1127: ErrorDocument 403 /adm/login
1128: ErrorDocument 500 /adm/errorhandler
1129: </Location>
1130:
1131: =head1 OVERVIEW
1132:
1133: =head2 Choosing Roles
1134:
1135: C<lonroles> is a handler that allows a user to switch roles in
1136: mid-session. LON-CAPA attempts to work with "No Role Specified", the
1137: default role that a user has before selecting a role, as widely as
1138: possible, but certain handlers for example need specification which
1139: course they should act on, etc. Both in this scenario, and when the
1140: handler determines via C<lonnet>'s C<&allowed> function that a certain
1141: action is not allowed, C<lonroles> is used as error handler. This
1142: allows the user to select another role which may have permission to do
1143: what they were trying to do. C<lonroles> can also be accessed via the
1144: B<CRS> button in the Remote Control.
1145:
1146: =begin latex
1147:
1148: \begin{figure}
1149: \begin{center}
1150: \includegraphics[width=0.45\paperwidth,keepaspectratio]{Sample_Roles_Screen}
1151: \caption{\label{Sample_Roles_Screen}Sample Roles Screen}
1152: \end{center}
1153: \end{figure}
1154:
1155: =end latex
1156:
1157: =head2 Role Initialization
1158:
1159: The privileges for a user are established at login time and stored in the session environment. As a consequence, a new role does not become active till the next login. Handlers are able to query for privileges using C<lonnet>'s C<&allowed> function. When a user first logs in, their role is the "common" role, which means that they have the sum of all of their privileges. During a session it might become necessary to choose a particular role, which as a consequence also limits the user to only the privileges in that particular role.
1160:
1161: =head1 INTRODUCTION
1162:
1163: This module enables a user to select what role he wishes to
1164: operate under (instructor, student, teaching assistant, course
1165: coordinator, etc). These roles are pre-established by the actions
1166: of upper-level users.
1167:
1168: This is part of the LearningOnline Network with CAPA project
1169: described at http://www.lon-capa.org.
1170:
1171: =head1 HANDLER SUBROUTINE
1172:
1173: This routine is called by Apache and mod_perl.
1174:
1175: =over 4
1176:
1177: =item *
1178:
1179: Roles Initialization (yes/no)
1180:
1181: =item *
1182:
1183: Get Error Message from Environment
1184:
1185: =item *
1186:
1187: Who is this?
1188:
1189: =item *
1190:
1191: Generate Page Output
1192:
1193: =item *
1194:
1195: Choice or no choice
1196:
1197: =item *
1198:
1199: Table
1200:
1201: =item *
1202:
1203: Privileges
1204:
1205: =back
1206:
1207: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>