1: #!/usr/bin/perl
2: # The LearningOnline Network
3: # lond "LON Daemon" Server (port "LOND" 5663)
4: #
5: # $Id: lond,v 1.189 2004/05/07 17:51:58 www Exp $
6: #
7: # Copyright Michigan State University Board of Trustees
8: #
9: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
10: #
11: # LON-CAPA is free software; you can redistribute it and/or modify
12: # it under the terms of the GNU General Public License as published by
13: # the Free Software Foundation; either version 2 of the License, or
14: # (at your option) any later version.
15: #
16: # LON-CAPA is distributed in the hope that it will be useful,
17: # but WITHOUT ANY WARRANTY; without even the implied warranty of
18: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19: # GNU General Public License for more details.
20: #
21: # You should have received a copy of the GNU General Public License
22: # along with LON-CAPA; if not, write to the Free Software
23: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24: #
25: # /home/httpd/html/adm/gpl.txt
26: #
27:
28:
29: # http://www.lon-capa.org/
30: #
31:
32: use strict;
33: use lib '/home/httpd/lib/perl/';
34: use LONCAPA::Configuration;
35:
36: use IO::Socket;
37: use IO::File;
38: #use Apache::File;
39: use Symbol;
40: use POSIX;
41: use Crypt::IDEA;
42: use LWP::UserAgent();
43: use GDBM_File;
44: use Authen::Krb4;
45: use Authen::Krb5;
46: use lib '/home/httpd/lib/perl/';
47: use localauth;
48: use File::Copy;
49: use LONCAPA::ConfigFileEdit;
50:
51: my $DEBUG = 0; # Non zero to enable debug log entries.
52:
53: my $status='';
54: my $lastlog='';
55:
56: my $VERSION='$Revision: 1.189 $'; #' stupid emacs
57: my $remoteVERSION;
58: my $currenthostid;
59: my $currentdomainid;
60:
61: my $client;
62: my $clientip;
63: my $clientname;
64:
65: my $server;
66: my $thisserver;
67:
68: #
69: # Connection type is:
70: # client - All client actions are allowed
71: # manager - only management functions allowed.
72: # both - Both management and client actions are allowed
73: #
74:
75: my $ConnectionType;
76:
77: my %hostid;
78: my %hostdom;
79: my %hostip;
80:
81: my %managers; # Ip -> manager names
82:
83: my %perlvar; # Will have the apache conf defined perl vars.
84:
85: #
86: # The array below are password error strings."
87: #
88: my $lastpwderror = 13; # Largest error number from lcpasswd.
89: my @passwderrors = ("ok",
90: "lcpasswd must be run as user 'www'",
91: "lcpasswd got incorrect number of arguments",
92: "lcpasswd did not get the right nubmer of input text lines",
93: "lcpasswd too many simultaneous pwd changes in progress",
94: "lcpasswd User does not exist.",
95: "lcpasswd Incorrect current passwd",
96: "lcpasswd Unable to su to root.",
97: "lcpasswd Cannot set new passwd.",
98: "lcpasswd Username has invalid characters",
99: "lcpasswd Invalid characters in password",
100: "11", "12",
101: "lcpasswd Password mismatch");
102:
103:
104: # The array below are lcuseradd error strings.:
105:
106: my $lastadderror = 13;
107: my @adderrors = ("ok",
108: "User ID mismatch, lcuseradd must run as user www",
109: "lcuseradd Incorrect number of command line parameters must be 3",
110: "lcuseradd Incorrect number of stdinput lines, must be 3",
111: "lcuseradd Too many other simultaneous pwd changes in progress",
112: "lcuseradd User does not exist",
113: "lcuseradd Unable to make www member of users's group",
114: "lcuseradd Unable to su to root",
115: "lcuseradd Unable to set password",
116: "lcuseradd Usrname has invalid characters",
117: "lcuseradd Password has an invalid character",
118: "lcuseradd User already exists",
119: "lcuseradd Could not add user.",
120: "lcuseradd Password mismatch");
121:
122:
123: #
124: # GetCertificate: Given a transaction that requires a certificate,
125: # this function will extract the certificate from the transaction
126: # request. Note that at this point, the only concept of a certificate
127: # is the hostname to which we are connected.
128: #
129: # Parameter:
130: # request - The request sent by our client (this parameterization may
131: # need to change when we really use a certificate granting
132: # authority.
133: #
134: sub GetCertificate {
135: my $request = shift;
136:
137: return $clientip;
138: }
139:
140: #
141: # Return true if client is a manager.
142: #
143: sub isManager {
144: return (($ConnectionType eq "manager") || ($ConnectionType eq "both"));
145: }
146: #
147: # Return tru if client can do client functions
148: #
149: sub isClient {
150: return (($ConnectionType eq "client") || ($ConnectionType eq "both"));
151: }
152:
153:
154: #
155: # ReadManagerTable: Reads in the current manager table. For now this is
156: # done on each manager authentication because:
157: # - These authentications are not frequent
158: # - This allows dynamic changes to the manager table
159: # without the need to signal to the lond.
160: #
161:
162: sub ReadManagerTable {
163:
164: # Clean out the old table first..
165:
166: foreach my $key (keys %managers) {
167: delete $managers{$key};
168: }
169:
170: my $tablename = $perlvar{'lonTabDir'}."/managers.tab";
171: if (!open (MANAGERS, $tablename)) {
172: logthis('<font color="red">No manager table. Nobody can manage!!</font>');
173: return;
174: }
175: while(my $host = <MANAGERS>) {
176: chomp($host);
177: if ($host =~ "^#") { # Comment line.
178: logthis('<font color="green"> Skipping line: '. "$host</font>\n");
179: next;
180: }
181: if (!defined $hostip{$host}) { # This is a non cluster member
182: # The entry is of the form:
183: # cluname:hostname
184: # cluname - A 'cluster hostname' is needed in order to negotiate
185: # the host key.
186: # hostname- The dns name of the host.
187: #
188: my($cluname, $dnsname) = split(/:/, $host);
189:
190: my $ip = gethostbyname($dnsname);
191: if(defined($ip)) { # bad names don't deserve entry.
192: my $hostip = inet_ntoa($ip);
193: $managers{$hostip} = $cluname;
194: logthis('<font color="green"> registering manager '.
195: "$dnsname as $cluname with $hostip </font>\n");
196: }
197: } else {
198: logthis('<font color="green"> existing host'." $host</font>\n");
199: $managers{$hostip{$host}} = $host; # Use info from cluster tab if clumemeber
200: }
201: }
202: }
203:
204: #
205: # ValidManager: Determines if a given certificate represents a valid manager.
206: # in this primitive implementation, the 'certificate' is
207: # just the connecting loncapa client name. This is checked
208: # against a valid client list in the configuration.
209: #
210: #
211: sub ValidManager {
212: my $certificate = shift;
213:
214: return isManager;
215: }
216: #
217: # CopyFile: Called as part of the process of installing a
218: # new configuration file. This function copies an existing
219: # file to a backup file.
220: # Parameters:
221: # oldfile - Name of the file to backup.
222: # newfile - Name of the backup file.
223: # Return:
224: # 0 - Failure (errno has failure reason).
225: # 1 - Success.
226: #
227: sub CopyFile {
228: my $oldfile = shift;
229: my $newfile = shift;
230:
231: # The file must exist:
232:
233: if(-e $oldfile) {
234:
235: # Read the old file.
236:
237: my $oldfh = IO::File->new("< $oldfile");
238: if(!$oldfh) {
239: return 0;
240: }
241: my @contents = <$oldfh>; # Suck in the entire file.
242:
243: # write the backup file:
244:
245: my $newfh = IO::File->new("> $newfile");
246: if(!(defined $newfh)){
247: return 0;
248: }
249: my $lines = scalar @contents;
250: for (my $i =0; $i < $lines; $i++) {
251: print $newfh ($contents[$i]);
252: }
253:
254: $oldfh->close;
255: $newfh->close;
256:
257: chmod(0660, $newfile);
258:
259: return 1;
260:
261: } else {
262: return 0;
263: }
264: }
265: #
266: # Host files are passed out with externally visible host IPs.
267: # If, for example, we are behind a fire-wall or NAT host, our
268: # internally visible IP may be different than the externally
269: # visible IP. Therefore, we always adjust the contents of the
270: # host file so that the entry for ME is the IP that we believe
271: # we have. At present, this is defined as the entry that
272: # DNS has for us. If by some chance we are not able to get a
273: # DNS translation for us, then we assume that the host.tab file
274: # is correct.
275: # BUGBUGBUG - in the future, we really should see if we can
276: # easily query the interface(s) instead.
277: # Parameter(s):
278: # contents - The contents of the host.tab to check.
279: # Returns:
280: # newcontents - The adjusted contents.
281: #
282: #
283: sub AdjustHostContents {
284: my $contents = shift;
285: my $adjusted;
286: my $me = $perlvar{'lonHostID'};
287:
288: foreach my $line (split(/\n/,$contents)) {
289: if(!(($line eq "") || ($line =~ /^ *\#/) || ($line =~ /^ *$/))) {
290: chomp($line);
291: my ($id,$domain,$role,$name,$ip,$maxcon,$idleto,$mincon)=split(/:/,$line);
292: if ($id eq $me) {
293: my $ip = gethostbyname($name);
294: my $ipnew = inet_ntoa($ip);
295: $ip = $ipnew;
296: # Reconstruct the host line and append to adjusted:
297:
298: my $newline = "$id:$domain:$role:$name:$ip";
299: if($maxcon ne "") { # Not all hosts have loncnew tuning params
300: $newline .= ":$maxcon:$idleto:$mincon";
301: }
302: $adjusted .= $newline."\n";
303:
304: } else { # Not me, pass unmodified.
305: $adjusted .= $line."\n";
306: }
307: } else { # Blank or comment never re-written.
308: $adjusted .= $line."\n"; # Pass blanks and comments as is.
309: }
310: }
311: return $adjusted;
312: }
313: #
314: # InstallFile: Called to install an administrative file:
315: # - The file is created with <name>.tmp
316: # - The <name>.tmp file is then mv'd to <name>
317: # This lugubrious procedure is done to ensure that we are never without
318: # a valid, even if dated, version of the file regardless of who crashes
319: # and when the crash occurs.
320: #
321: # Parameters:
322: # Name of the file
323: # File Contents.
324: # Return:
325: # nonzero - success.
326: # 0 - failure and $! has an errno.
327: #
328: sub InstallFile {
329: my $Filename = shift;
330: my $Contents = shift;
331: my $TempFile = $Filename.".tmp";
332:
333: # Open the file for write:
334:
335: my $fh = IO::File->new("> $TempFile"); # Write to temp.
336: if(!(defined $fh)) {
337: &logthis('<font color="red"> Unable to create '.$TempFile."</font>");
338: return 0;
339: }
340: # write the contents of the file:
341:
342: print $fh ($Contents);
343: $fh->close; # In case we ever have a filesystem w. locking
344:
345: chmod(0660, $TempFile);
346:
347: # Now we can move install the file in position.
348:
349: move($TempFile, $Filename);
350:
351: return 1;
352: }
353: #
354: # ConfigFileFromSelector: converts a configuration file selector
355: # (one of host or domain at this point) into a
356: # configuration file pathname.
357: #
358: # Parameters:
359: # selector - Configuration file selector.
360: # Returns:
361: # Full path to the file or undef if the selector is invalid.
362: #
363: sub ConfigFileFromSelector {
364: my $selector = shift;
365: my $tablefile;
366:
367: my $tabledir = $perlvar{'lonTabDir'}.'/';
368: if ($selector eq "hosts") {
369: $tablefile = $tabledir."hosts.tab";
370: } elsif ($selector eq "domain") {
371: $tablefile = $tabledir."domain.tab";
372: } else {
373: return undef;
374: }
375: return $tablefile;
376:
377: }
378: #
379: # PushFile: Called to do an administrative push of a file.
380: # - Ensure the file being pushed is one we support.
381: # - Backup the old file to <filename.saved>
382: # - Separate the contents of the new file out from the
383: # rest of the request.
384: # - Write the new file.
385: # Parameter:
386: # Request - The entire user request. This consists of a : separated
387: # string pushfile:tablename:contents.
388: # NOTE: The contents may have :'s in it as well making things a bit
389: # more interesting... but not much.
390: # Returns:
391: # String to send to client ("ok" or "refused" if bad file).
392: #
393: sub PushFile {
394: my $request = shift;
395: my ($command, $filename, $contents) = split(":", $request, 3);
396:
397: # At this point in time, pushes for only the following tables are
398: # supported:
399: # hosts.tab ($filename eq host).
400: # domain.tab ($filename eq domain).
401: # Construct the destination filename or reject the request.
402: #
403: # lonManage is supposed to ensure this, however this session could be
404: # part of some elaborate spoof that managed somehow to authenticate.
405: #
406:
407:
408: my $tablefile = ConfigFileFromSelector($filename);
409: if(! (defined $tablefile)) {
410: return "refused";
411: }
412: #
413: # >copy< the old table to the backup table
414: # don't rename in case system crashes/reboots etc. in the time
415: # window between a rename and write.
416: #
417: my $backupfile = $tablefile;
418: $backupfile =~ s/\.tab$/.old/;
419: if(!CopyFile($tablefile, $backupfile)) {
420: &logthis('<font color="green"> CopyFile from '.$tablefile." to ".$backupfile." failed </font>");
421: return "error:$!";
422: }
423: &logthis('<font color="green"> Pushfile: backed up '
424: .$tablefile." to $backupfile</font>");
425:
426: # If the file being pushed is the host file, we adjust the entry for ourself so that the
427: # IP will be our current IP as looked up in dns. Note this is only 99% good as it's possible
428: # to conceive of conditions where we don't have a DNS entry locally. This is possible in a
429: # network sense but it doesn't make much sense in a LonCAPA sense so we ignore (for now)
430: # that possibilty.
431:
432: if($filename eq "host") {
433: $contents = AdjustHostContents($contents);
434: }
435:
436: # Install the new file:
437:
438: if(!InstallFile($tablefile, $contents)) {
439: &logthis('<font color="red"> Pushfile: unable to install '
440: .$tablefile." $! </font>");
441: return "error:$!";
442: }
443: else {
444: &logthis('<font color="green"> Installed new '.$tablefile
445: ."</font>");
446:
447: }
448:
449:
450: # Indicate success:
451:
452: return "ok";
453:
454: }
455:
456: #
457: # Called to re-init either lonc or lond.
458: #
459: # Parameters:
460: # request - The full request by the client. This is of the form
461: # reinit:<process>
462: # where <process> is allowed to be either of
463: # lonc or lond
464: #
465: # Returns:
466: # The string to be sent back to the client either:
467: # ok - Everything worked just fine.
468: # error:why - There was a failure and why describes the reason.
469: #
470: #
471: sub ReinitProcess {
472: my $request = shift;
473:
474:
475: # separate the request (reinit) from the process identifier and
476: # validate it producing the name of the .pid file for the process.
477: #
478: #
479: my ($junk, $process) = split(":", $request);
480: my $processpidfile = $perlvar{'lonDaemons'}.'/logs/';
481: if($process eq 'lonc') {
482: $processpidfile = $processpidfile."lonc.pid";
483: if (!open(PIDFILE, "< $processpidfile")) {
484: return "error:Open failed for $processpidfile";
485: }
486: my $loncpid = <PIDFILE>;
487: close(PIDFILE);
488: logthis('<font color="red"> Reinitializing lonc pid='.$loncpid
489: ."</font>");
490: kill("USR2", $loncpid);
491: } elsif ($process eq 'lond') {
492: logthis('<font color="red"> Reinitializing self (lond) </font>');
493: &UpdateHosts; # Lond is us!!
494: } else {
495: &logthis('<font color="yellow" Invalid reinit request for '.$process
496: ."</font>");
497: return "error:Invalid process identifier $process";
498: }
499: return 'ok';
500: }
501: # Validate a line in a configuration file edit script:
502: # Validation includes:
503: # - Ensuring the command is valid.
504: # - Ensuring the command has sufficient parameters
505: # Parameters:
506: # scriptline - A line to validate (\n has been stripped for what it's worth).
507: #
508: # Return:
509: # 0 - Invalid scriptline.
510: # 1 - Valid scriptline
511: # NOTE:
512: # Only the command syntax is checked, not the executability of the
513: # command.
514: #
515: sub isValidEditCommand {
516: my $scriptline = shift;
517:
518: # Line elements are pipe separated:
519:
520: my ($command, $key, $newline) = split(/\|/, $scriptline);
521: &logthis('<font color="green"> isValideditCommand checking: '.
522: "Command = '$command', Key = '$key', Newline = '$newline' </font>\n");
523:
524: if ($command eq "delete") {
525: #
526: # key with no newline.
527: #
528: if( ($key eq "") || ($newline ne "")) {
529: return 0; # Must have key but no newline.
530: } else {
531: return 1; # Valid syntax.
532: }
533: } elsif ($command eq "replace") {
534: #
535: # key and newline:
536: #
537: if (($key eq "") || ($newline eq "")) {
538: return 0;
539: } else {
540: return 1;
541: }
542: } elsif ($command eq "append") {
543: if (($key ne "") && ($newline eq "")) {
544: return 1;
545: } else {
546: return 0;
547: }
548: } else {
549: return 0; # Invalid command.
550: }
551: return 0; # Should not get here!!!
552: }
553: #
554: # ApplyEdit - Applies an edit command to a line in a configuration
555: # file. It is the caller's responsiblity to validate the
556: # edit line.
557: # Parameters:
558: # $directive - A single edit directive to apply.
559: # Edit directives are of the form:
560: # append|newline - Appends a new line to the file.
561: # replace|key|newline - Replaces the line with key value 'key'
562: # delete|key - Deletes the line with key value 'key'.
563: # $editor - A config file editor object that contains the
564: # file being edited.
565: #
566: sub ApplyEdit {
567: my $directive = shift;
568: my $editor = shift;
569:
570: # Break the directive down into its command and its parameters
571: # (at most two at this point. The meaning of the parameters, if in fact
572: # they exist depends on the command).
573:
574: my ($command, $p1, $p2) = split(/\|/, $directive);
575:
576: if($command eq "append") {
577: $editor->Append($p1); # p1 - key p2 null.
578: } elsif ($command eq "replace") {
579: $editor->ReplaceLine($p1, $p2); # p1 - key p2 = newline.
580: } elsif ($command eq "delete") {
581: $editor->DeleteLine($p1); # p1 - key p2 null.
582: } else { # Should not get here!!!
583: die "Invalid command given to ApplyEdit $command"
584: }
585: }
586: #
587: # AdjustOurHost:
588: # Adjusts a host file stored in a configuration file editor object
589: # for the true IP address of this host. This is necessary for hosts
590: # that live behind a firewall.
591: # Those hosts have a publicly distributed IP of the firewall, but
592: # internally must use their actual IP. We assume that a given
593: # host only has a single IP interface for now.
594: # Formal Parameters:
595: # editor - The configuration file editor to adjust. This
596: # editor is assumed to contain a hosts.tab file.
597: # Strategy:
598: # - Figure out our hostname.
599: # - Lookup the entry for this host.
600: # - Modify the line to contain our IP
601: # - Do a replace for this host.
602: sub AdjustOurHost {
603: my $editor = shift;
604:
605: # figure out who I am.
606:
607: my $myHostName = $perlvar{'lonHostID'}; # LonCAPA hostname.
608:
609: # Get my host file entry.
610:
611: my $ConfigLine = $editor->Find($myHostName);
612: if(! (defined $ConfigLine)) {
613: die "AdjustOurHost - no entry for me in hosts file $myHostName";
614: }
615: # figure out my IP:
616: # Use the config line to get my hostname.
617: # Use gethostbyname to translate that into an IP address.
618: #
619: my ($id,$domain,$role,$name,$ip,$maxcon,$idleto,$mincon) = split(/:/,$ConfigLine);
620: my $BinaryIp = gethostbyname($name);
621: my $ip = inet_ntoa($ip);
622: #
623: # Reassemble the config line from the elements in the list.
624: # Note that if the loncnew items were not present before, they will
625: # be now even if they would be empty
626: #
627: my $newConfigLine = $id;
628: foreach my $item ($domain, $role, $name, $ip, $maxcon, $idleto, $mincon) {
629: $newConfigLine .= ":".$item;
630: }
631: # Replace the line:
632:
633: $editor->ReplaceLine($id, $newConfigLine);
634:
635: }
636: #
637: # ReplaceConfigFile:
638: # Replaces a configuration file with the contents of a
639: # configuration file editor object.
640: # This is done by:
641: # - Copying the target file to <filename>.old
642: # - Writing the new file to <filename>.tmp
643: # - Moving <filename.tmp> -> <filename>
644: # This laborious process ensures that the system is never without
645: # a configuration file that's at least valid (even if the contents
646: # may be dated).
647: # Parameters:
648: # filename - Name of the file to modify... this is a full path.
649: # editor - Editor containing the file.
650: #
651: sub ReplaceConfigFile {
652: my $filename = shift;
653: my $editor = shift;
654:
655: CopyFile ($filename, $filename.".old");
656:
657: my $contents = $editor->Get(); # Get the contents of the file.
658:
659: InstallFile($filename, $contents);
660: }
661: #
662: #
663: # Called to edit a configuration table file
664: # Parameters:
665: # request - The entire command/request sent by lonc or lonManage
666: # Return:
667: # The reply to send to the client.
668: #
669: sub EditFile {
670: my $request = shift;
671:
672: # Split the command into it's pieces: edit:filetype:script
673:
674: my ($request, $filetype, $script) = split(/:/, $request,3); # : in script
675:
676: # Check the pre-coditions for success:
677:
678: if($request != "edit") { # Something is amiss afoot alack.
679: return "error:edit request detected, but request != 'edit'\n";
680: }
681: if( ($filetype ne "hosts") &&
682: ($filetype ne "domain")) {
683: return "error:edit requested with invalid file specifier: $filetype \n";
684: }
685:
686: # Split the edit script and check it's validity.
687:
688: my @scriptlines = split(/\n/, $script); # one line per element.
689: my $linecount = scalar(@scriptlines);
690: for(my $i = 0; $i < $linecount; $i++) {
691: chomp($scriptlines[$i]);
692: if(!isValidEditCommand($scriptlines[$i])) {
693: return "error:edit with bad script line: '$scriptlines[$i]' \n";
694: }
695: }
696:
697: # Execute the edit operation.
698: # - Create a config file editor for the appropriate file and
699: # - execute each command in the script:
700: #
701: my $configfile = ConfigFileFromSelector($filetype);
702: if (!(defined $configfile)) {
703: return "refused\n";
704: }
705: my $editor = ConfigFileEdit->new($configfile);
706:
707: for (my $i = 0; $i < $linecount; $i++) {
708: ApplyEdit($scriptlines[$i], $editor);
709: }
710: # If the file is the host file, ensure that our host is
711: # adjusted to have our ip:
712: #
713: if($filetype eq "host") {
714: AdjustOurHost($editor);
715: }
716: # Finally replace the current file with our file.
717: #
718: ReplaceConfigFile($configfile, $editor);
719:
720: return "ok\n";
721: }
722: #
723: # Convert an error return code from lcpasswd to a string value.
724: #
725: sub lcpasswdstrerror {
726: my $ErrorCode = shift;
727: if(($ErrorCode < 0) || ($ErrorCode > $lastpwderror)) {
728: return "lcpasswd Unrecognized error return value ".$ErrorCode;
729: } else {
730: return $passwderrors[$ErrorCode];
731: }
732: }
733:
734: #
735: # Convert an error return code from lcuseradd to a string value:
736: #
737: sub lcuseraddstrerror {
738: my $ErrorCode = shift;
739: if(($ErrorCode < 0) || ($ErrorCode > $lastadderror)) {
740: return "lcuseradd - Unrecognized error code: ".$ErrorCode;
741: } else {
742: return $adderrors[$ErrorCode];
743: }
744: }
745:
746: # grabs exception and records it to log before exiting
747: sub catchexception {
748: my ($error)=@_;
749: $SIG{'QUIT'}='DEFAULT';
750: $SIG{__DIE__}='DEFAULT';
751: &status("Catching exception");
752: &logthis("<font color=red>CRITICAL: "
753: ."ABNORMAL EXIT. Child $$ for server $thisserver died through "
754: ."a crash with this error msg->[$error]</font>");
755: &logthis('Famous last words: '.$status.' - '.$lastlog);
756: if ($client) { print $client "error: $error\n"; }
757: $server->close();
758: die($error);
759: }
760:
761: sub timeout {
762: &status("Handling Timeout");
763: &logthis("<font color=ref>CRITICAL: TIME OUT ".$$."</font>");
764: &catchexception('Timeout');
765: }
766: # -------------------------------- Set signal handlers to record abnormal exits
767:
768: $SIG{'QUIT'}=\&catchexception;
769: $SIG{__DIE__}=\&catchexception;
770:
771: # ---------------------------------- Read loncapa_apache.conf and loncapa.conf
772: &status("Read loncapa.conf and loncapa_apache.conf");
773: my $perlvarref=LONCAPA::Configuration::read_conf('loncapa.conf');
774: %perlvar=%{$perlvarref};
775: undef $perlvarref;
776:
777: # ----------------------------- Make sure this process is running from user=www
778: my $wwwid=getpwnam('www');
779: if ($wwwid!=$<) {
780: my $emailto="$perlvar{'lonAdmEMail'},$perlvar{'lonSysEMail'}";
781: my $subj="LON: $currenthostid User ID mismatch";
782: system("echo 'User ID mismatch. lond must be run as user www.' |\
783: mailto $emailto -s '$subj' > /dev/null");
784: exit 1;
785: }
786:
787: # --------------------------------------------- Check if other instance running
788:
789: my $pidfile="$perlvar{'lonDaemons'}/logs/lond.pid";
790:
791: if (-e $pidfile) {
792: my $lfh=IO::File->new("$pidfile");
793: my $pide=<$lfh>;
794: chomp($pide);
795: if (kill 0 => $pide) { die "already running"; }
796: }
797:
798: # ------------------------------------------------------------- Read hosts file
799:
800:
801:
802: # establish SERVER socket, bind and listen.
803: $server = IO::Socket::INET->new(LocalPort => $perlvar{'londPort'},
804: Type => SOCK_STREAM,
805: Proto => 'tcp',
806: Reuse => 1,
807: Listen => 10 )
808: or die "making socket: $@\n";
809:
810: # --------------------------------------------------------- Do global variables
811:
812: # global variables
813:
814: my %children = (); # keys are current child process IDs
815:
816: sub REAPER { # takes care of dead children
817: $SIG{CHLD} = \&REAPER;
818: &status("Handling child death");
819: my $pid;
820: do {
821: $pid = waitpid(-1,&WNOHANG());
822: if (defined($children{$pid})) {
823: &logthis("Child $pid died");
824: delete($children{$pid});
825: } elsif ($pid > 0) {
826: &logthis("Unknown Child $pid died");
827: }
828: } while ( $pid > 0 );
829: foreach my $child (keys(%children)) {
830: $pid = waitpid($child,&WNOHANG());
831: if ($pid > 0) {
832: &logthis("Child $child - $pid looks like we missed it's death");
833: delete($children{$pid});
834: }
835: }
836: &status("Finished Handling child death");
837: }
838:
839: sub HUNTSMAN { # signal handler for SIGINT
840: &status("Killing children (INT)");
841: local($SIG{CHLD}) = 'IGNORE'; # we're going to kill our children
842: kill 'INT' => keys %children;
843: &logthis("Free socket: ".shutdown($server,2)); # free up socket
844: my $execdir=$perlvar{'lonDaemons'};
845: unlink("$execdir/logs/lond.pid");
846: &logthis("<font color=red>CRITICAL: Shutting down</font>");
847: &status("Done killing children");
848: exit; # clean up with dignity
849: }
850:
851: sub HUPSMAN { # signal handler for SIGHUP
852: local($SIG{CHLD}) = 'IGNORE'; # we're going to kill our children
853: &status("Killing children for restart (HUP)");
854: kill 'INT' => keys %children;
855: &logthis("Free socket: ".shutdown($server,2)); # free up socket
856: &logthis("<font color=red>CRITICAL: Restarting</font>");
857: my $execdir=$perlvar{'lonDaemons'};
858: unlink("$execdir/logs/lond.pid");
859: &status("Restarting self (HUP)");
860: exec("$execdir/lond"); # here we go again
861: }
862:
863: #
864: # Kill off hashes that describe the host table prior to re-reading it.
865: # Hashes affected are:
866: # %hostid, %hostdom %hostip
867: #
868: sub KillHostHashes {
869: foreach my $key (keys %hostid) {
870: delete $hostid{$key};
871: }
872: foreach my $key (keys %hostdom) {
873: delete $hostdom{$key};
874: }
875: foreach my $key (keys %hostip) {
876: delete $hostip{$key};
877: }
878: }
879: #
880: # Read in the host table from file and distribute it into the various hashes:
881: #
882: # - %hostid - Indexed by IP, the loncapa hostname.
883: # - %hostdom - Indexed by loncapa hostname, the domain.
884: # - %hostip - Indexed by hostid, the Ip address of the host.
885: sub ReadHostTable {
886:
887: open (CONFIG,"$perlvar{'lonTabDir'}/hosts.tab") || die "Can't read host file";
888:
889: while (my $configline=<CONFIG>) {
890: if (!($configline =~ /^\s*\#/)) {
891: my ($id,$domain,$role,$name,$ip)=split(/:/,$configline);
892: chomp($ip); $ip=~s/\D+$//;
893: $hostid{$ip}=$id;
894: $hostdom{$id}=$domain;
895: $hostip{$id}=$ip;
896: if ($id eq $perlvar{'lonHostID'}) { $thisserver=$name; }
897: }
898: }
899: close(CONFIG);
900: }
901: #
902: # Reload the Apache daemon's state.
903: # This is done by invoking /home/httpd/perl/apachereload
904: # a setuid perl script that can be root for us to do this job.
905: #
906: sub ReloadApache {
907: my $execdir = $perlvar{'lonDaemons'};
908: my $script = $execdir."/apachereload";
909: system($script);
910: }
911:
912: #
913: # Called in response to a USR2 signal.
914: # - Reread hosts.tab
915: # - All children connected to hosts that were removed from hosts.tab
916: # are killed via SIGINT
917: # - All children connected to previously existing hosts are sent SIGUSR1
918: # - Our internal hosts hash is updated to reflect the new contents of
919: # hosts.tab causing connections from hosts added to hosts.tab to
920: # now be honored.
921: #
922: sub UpdateHosts {
923: &status("Reload hosts.tab");
924: logthis('<font color="blue"> Updating connections </font>');
925: #
926: # The %children hash has the set of IP's we currently have children
927: # on. These need to be matched against records in the hosts.tab
928: # Any ip's no longer in the table get killed off they correspond to
929: # either dropped or changed hosts. Note that the re-read of the table
930: # will take care of new and changed hosts as connections come into being.
931:
932:
933: KillHostHashes;
934: ReadHostTable;
935:
936: foreach my $child (keys %children) {
937: my $childip = $children{$child};
938: if(!$hostid{$childip}) {
939: logthis('<font color="blue"> UpdateHosts killing child '
940: ." $child for ip $childip </font>");
941: kill('INT', $child);
942: } else {
943: logthis('<font color="green"> keeping child for ip '
944: ." $childip (pid=$child) </font>");
945: }
946: }
947: ReloadApache;
948: &status("Finished reloading hosts.tab");
949: }
950:
951:
952: sub checkchildren {
953: &status("Checking on the children (sending signals)");
954: &initnewstatus();
955: &logstatus();
956: &logthis('Going to check on the children');
957: my $docdir=$perlvar{'lonDocRoot'};
958: foreach (sort keys %children) {
959: sleep 1;
960: unless (kill 'USR1' => $_) {
961: &logthis ('Child '.$_.' is dead');
962: &logstatus($$.' is dead');
963: }
964: }
965: sleep 5;
966: $SIG{ALRM} = sub { die "timeout" };
967: $SIG{__DIE__} = 'DEFAULT';
968: &status("Checking on the children (waiting for reports)");
969: foreach (sort keys %children) {
970: unless (-e "$docdir/lon-status/londchld/$_.txt") {
971: eval {
972: alarm(300);
973: &logthis('Child '.$_.' did not respond');
974: kill 9 => $_;
975: #$emailto="$perlvar{'lonAdmEMail'},$perlvar{'lonSysEMail'}";
976: #$subj="LON: $currenthostid killed lond process $_";
977: #my $result=`echo 'Killed lond process $_.' | mailto $emailto -s '$subj' > /dev/null`;
978: #$execdir=$perlvar{'lonDaemons'};
979: #$result=`/bin/cp $execdir/logs/lond.log $execdir/logs/lond.log.$_`;
980: alarm(0);
981: }
982: }
983: }
984: $SIG{ALRM} = 'DEFAULT';
985: $SIG{__DIE__} = \&catchexception;
986: &status("Finished checking children");
987: }
988:
989: # --------------------------------------------------------------------- Logging
990:
991: sub logthis {
992: my $message=shift;
993: my $execdir=$perlvar{'lonDaemons'};
994: my $fh=IO::File->new(">>$execdir/logs/lond.log");
995: my $now=time;
996: my $local=localtime($now);
997: $lastlog=$local.': '.$message;
998: print $fh "$local ($$): $message\n";
999: }
1000:
1001: # ------------------------- Conditional log if $DEBUG true.
1002: sub Debug {
1003: my $message = shift;
1004: if($DEBUG) {
1005: &logthis($message);
1006: }
1007: }
1008:
1009: #
1010: # Sub to do replies to client.. this gives a hook for some
1011: # debug tracing too:
1012: # Parameters:
1013: # fd - File open on client.
1014: # reply - Text to send to client.
1015: # request - Original request from client.
1016: #
1017: sub Reply {
1018: my $fd = shift;
1019: my $reply = shift;
1020: my $request = shift;
1021:
1022: print $fd $reply;
1023: Debug("Request was $request Reply was $reply");
1024:
1025: }
1026: # ------------------------------------------------------------------ Log status
1027:
1028: sub logstatus {
1029: &status("Doing logging");
1030: my $docdir=$perlvar{'lonDocRoot'};
1031: {
1032: my $fh=IO::File->new(">>$docdir/lon-status/londstatus.txt");
1033: print $fh $$."\t".$clientname."\t".$currenthostid."\t".$status."\t".$lastlog."\n";
1034: $fh->close();
1035: }
1036: &status("Finished londstatus.txt");
1037: {
1038: my $fh=IO::File->new(">$docdir/lon-status/londchld/$$.txt");
1039: print $fh $status."\n".$lastlog."\n".time;
1040: $fh->close();
1041: }
1042: &status("Finished logging");
1043: }
1044:
1045: sub initnewstatus {
1046: my $docdir=$perlvar{'lonDocRoot'};
1047: my $fh=IO::File->new(">$docdir/lon-status/londstatus.txt");
1048: my $now=time;
1049: my $local=localtime($now);
1050: print $fh "LOND status $local - parent $$\n\n";
1051: opendir(DIR,"$docdir/lon-status/londchld");
1052: while (my $filename=readdir(DIR)) {
1053: unlink("$docdir/lon-status/londchld/$filename");
1054: }
1055: closedir(DIR);
1056: }
1057:
1058: # -------------------------------------------------------------- Status setting
1059:
1060: sub status {
1061: my $what=shift;
1062: my $now=time;
1063: my $local=localtime($now);
1064: $status=$local.': '.$what;
1065: $0='lond: '.$what.' '.$local;
1066: }
1067:
1068: # -------------------------------------------------------- Escape Special Chars
1069:
1070: sub escape {
1071: my $str=shift;
1072: $str =~ s/(\W)/"%".unpack('H2',$1)/eg;
1073: return $str;
1074: }
1075:
1076: # ----------------------------------------------------- Un-Escape Special Chars
1077:
1078: sub unescape {
1079: my $str=shift;
1080: $str =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
1081: return $str;
1082: }
1083:
1084: # ----------------------------------------------------------- Send USR1 to lonc
1085:
1086: sub reconlonc {
1087: my $peerfile=shift;
1088: &logthis("Trying to reconnect for $peerfile");
1089: my $loncfile="$perlvar{'lonDaemons'}/logs/lonc.pid";
1090: if (my $fh=IO::File->new("$loncfile")) {
1091: my $loncpid=<$fh>;
1092: chomp($loncpid);
1093: if (kill 0 => $loncpid) {
1094: &logthis("lonc at pid $loncpid responding, sending USR1");
1095: kill USR1 => $loncpid;
1096: } else {
1097: &logthis(
1098: "<font color=red>CRITICAL: "
1099: ."lonc at pid $loncpid not responding, giving up</font>");
1100: }
1101: } else {
1102: &logthis('<font color=red>CRITICAL: lonc not running, giving up</font>');
1103: }
1104: }
1105:
1106: # -------------------------------------------------- Non-critical communication
1107:
1108: sub subreply {
1109: my ($cmd,$server)=@_;
1110: my $peerfile="$perlvar{'lonSockDir'}/$server";
1111: my $sclient=IO::Socket::UNIX->new(Peer =>"$peerfile",
1112: Type => SOCK_STREAM,
1113: Timeout => 10)
1114: or return "con_lost";
1115: print $sclient "$cmd\n";
1116: my $answer=<$sclient>;
1117: chomp($answer);
1118: if (!$answer) { $answer="con_lost"; }
1119: return $answer;
1120: }
1121:
1122: sub reply {
1123: my ($cmd,$server)=@_;
1124: my $answer;
1125: if ($server ne $currenthostid) {
1126: $answer=subreply($cmd,$server);
1127: if ($answer eq 'con_lost') {
1128: $answer=subreply("ping",$server);
1129: if ($answer ne $server) {
1130: &logthis("sub reply: answer != server answer is $answer, server is $server");
1131: &reconlonc("$perlvar{'lonSockDir'}/$server");
1132: }
1133: $answer=subreply($cmd,$server);
1134: }
1135: } else {
1136: $answer='self_reply';
1137: }
1138: return $answer;
1139: }
1140:
1141: # -------------------------------------------------------------- Talk to lonsql
1142:
1143: sub sqlreply {
1144: my ($cmd)=@_;
1145: my $answer=subsqlreply($cmd);
1146: if ($answer eq 'con_lost') { $answer=subsqlreply($cmd); }
1147: return $answer;
1148: }
1149:
1150: sub subsqlreply {
1151: my ($cmd)=@_;
1152: my $unixsock="mysqlsock";
1153: my $peerfile="$perlvar{'lonSockDir'}/$unixsock";
1154: my $sclient=IO::Socket::UNIX->new(Peer =>"$peerfile",
1155: Type => SOCK_STREAM,
1156: Timeout => 10)
1157: or return "con_lost";
1158: print $sclient "$cmd\n";
1159: my $answer=<$sclient>;
1160: chomp($answer);
1161: if (!$answer) { $answer="con_lost"; }
1162: return $answer;
1163: }
1164:
1165: # -------------------------------------------- Return path to profile directory
1166:
1167: sub propath {
1168: my ($udom,$uname)=@_;
1169: $udom=~s/\W//g;
1170: $uname=~s/\W//g;
1171: my $subdir=$uname.'__';
1172: $subdir =~ s/(.)(.)(.).*/$1\/$2\/$3/;
1173: my $proname="$perlvar{'lonUsersDir'}/$udom/$subdir/$uname";
1174: return $proname;
1175: }
1176:
1177: # --------------------------------------- Is this the home server of an author?
1178:
1179: sub ishome {
1180: my $author=shift;
1181: $author=~s/\/home\/httpd\/html\/res\/([^\/]*)\/([^\/]*).*/$1\/$2/;
1182: my ($udom,$uname)=split(/\//,$author);
1183: my $proname=propath($udom,$uname);
1184: if (-e $proname) {
1185: return 'owner';
1186: } else {
1187: return 'not_owner';
1188: }
1189: }
1190:
1191: # ======================================================= Continue main program
1192: # ---------------------------------------------------- Fork once and dissociate
1193:
1194: my $fpid=fork;
1195: exit if $fpid;
1196: die "Couldn't fork: $!" unless defined ($fpid);
1197:
1198: POSIX::setsid() or die "Can't start new session: $!";
1199:
1200: # ------------------------------------------------------- Write our PID on disk
1201:
1202: my $execdir=$perlvar{'lonDaemons'};
1203: open (PIDSAVE,">$execdir/logs/lond.pid");
1204: print PIDSAVE "$$\n";
1205: close(PIDSAVE);
1206: &logthis("<font color=red>CRITICAL: ---------- Starting ----------</font>");
1207: &status('Starting');
1208:
1209:
1210:
1211: # ----------------------------------------------------- Install signal handlers
1212:
1213:
1214: $SIG{CHLD} = \&REAPER;
1215: $SIG{INT} = $SIG{TERM} = \&HUNTSMAN;
1216: $SIG{HUP} = \&HUPSMAN;
1217: $SIG{USR1} = \&checkchildren;
1218: $SIG{USR2} = \&UpdateHosts;
1219:
1220: # Read the host hashes:
1221:
1222: ReadHostTable;
1223:
1224: # --------------------------------------------------------------
1225: # Accept connections. When a connection comes in, it is validated
1226: # and if good, a child process is created to process transactions
1227: # along the connection.
1228:
1229: while (1) {
1230: &status('Starting accept');
1231: $client = $server->accept() or next;
1232: &status('Accepted '.$client.' off to spawn');
1233: make_new_child($client);
1234: &status('Finished spawning');
1235: }
1236:
1237: sub make_new_child {
1238: my $pid;
1239: my $cipher;
1240: my $sigset;
1241:
1242: $client = shift;
1243: &status('Starting new child '.$client);
1244: &logthis('<font color="green"> Attempting to start child ('.$client.
1245: ")</font>");
1246: # block signal for fork
1247: $sigset = POSIX::SigSet->new(SIGINT);
1248: sigprocmask(SIG_BLOCK, $sigset)
1249: or die "Can't block SIGINT for fork: $!\n";
1250:
1251: die "fork: $!" unless defined ($pid = fork);
1252:
1253: $client->sockopt(SO_KEEPALIVE, 1); # Enable monitoring of
1254: # connection liveness.
1255:
1256: #
1257: # Figure out who we're talking to so we can record the peer in
1258: # the pid hash.
1259: #
1260: my $caller = getpeername($client);
1261: my ($port,$iaddr);
1262: if (defined($caller) && length($caller) > 0) {
1263: ($port,$iaddr)=unpack_sockaddr_in($caller);
1264: } else {
1265: &logthis("Unable to determine who caller was, getpeername returned nothing");
1266: }
1267: if (defined($iaddr)) {
1268: $clientip=inet_ntoa($iaddr);
1269: } else {
1270: &logthis("Unable to determine clinetip");
1271: $clientip='Unavailable';
1272: }
1273:
1274: if ($pid) {
1275: # Parent records the child's birth and returns.
1276: sigprocmask(SIG_UNBLOCK, $sigset)
1277: or die "Can't unblock SIGINT for fork: $!\n";
1278: $children{$pid} = $clientip;
1279: &status('Started child '.$pid);
1280: return;
1281: } else {
1282: # Child can *not* return from this subroutine.
1283: $SIG{INT} = 'DEFAULT'; # make SIGINT kill us as it did before
1284: $SIG{CHLD} = 'DEFAULT'; #make this default so that pwauth returns
1285: #don't get intercepted
1286: $SIG{USR1}= \&logstatus;
1287: $SIG{ALRM}= \&timeout;
1288: $lastlog='Forked ';
1289: $status='Forked';
1290:
1291: # unblock signals
1292: sigprocmask(SIG_UNBLOCK, $sigset)
1293: or die "Can't unblock SIGINT for fork: $!\n";
1294:
1295: my $tmpsnum=0;
1296: #---------------------------------------------------- kerberos 5 initialization
1297: &Authen::Krb5::init_context();
1298: &Authen::Krb5::init_ets();
1299:
1300: &status('Accepted connection');
1301: # =============================================================================
1302: # do something with the connection
1303: # -----------------------------------------------------------------------------
1304: # see if we know client and check for spoof IP by challenge
1305:
1306: ReadManagerTable; # May also be a manager!!
1307:
1308: my $clientrec=($hostid{$clientip} ne undef);
1309: my $ismanager=($managers{$clientip} ne undef);
1310: $clientname = "[unknonwn]";
1311: if($clientrec) { # Establish client type.
1312: $ConnectionType = "client";
1313: $clientname = $hostid{$clientip};
1314: if($ismanager) {
1315: $ConnectionType = "both";
1316: }
1317: } else {
1318: $ConnectionType = "manager";
1319: $clientname = $managers{$clientip};
1320: }
1321: my $clientok;
1322: if ($clientrec || $ismanager) {
1323: &status("Waiting for init from $clientip $clientname");
1324: &logthis('<font color="yellow">INFO: Connection, '.
1325: $clientip.
1326: " ($clientname) connection type = $ConnectionType </font>" );
1327: &status("Connecting $clientip ($clientname))");
1328: my $remotereq=<$client>;
1329: $remotereq=~s/[^\w:]//g;
1330: if ($remotereq =~ /^init/) {
1331: &sethost("sethost:$perlvar{'lonHostID'}");
1332: my $challenge="$$".time;
1333: print $client "$challenge\n";
1334: &status(
1335: "Waiting for challenge reply from $clientip ($clientname)");
1336: $remotereq=<$client>;
1337: $remotereq=~s/\W//g;
1338: if ($challenge eq $remotereq) {
1339: $clientok=1;
1340: print $client "ok\n";
1341: } else {
1342: &logthis(
1343: "<font color=blue>WARNING: $clientip did not reply challenge</font>");
1344: &status('No challenge reply '.$clientip);
1345: }
1346: } else {
1347: &logthis(
1348: "<font color=blue>WARNING: "
1349: ."$clientip failed to initialize: >$remotereq< </font>");
1350: &status('No init '.$clientip);
1351: }
1352: } else {
1353: &logthis(
1354: "<font color=blue>WARNING: Unknown client $clientip</font>");
1355: &status('Hung up on '.$clientip);
1356: }
1357: if ($clientok) {
1358: # ---------------- New known client connecting, could mean machine online again
1359:
1360: foreach my $id (keys(%hostip)) {
1361: if ($hostip{$id} ne $clientip ||
1362: $hostip{$currenthostid} eq $clientip) {
1363: # no need to try to do recon's to myself
1364: next;
1365: }
1366: &reconlonc("$perlvar{'lonSockDir'}/$id");
1367: }
1368: &logthis("<font color=green>Established connection: $clientname</font>");
1369: &status('Will listen to '.$clientname);
1370: # ------------------------------------------------------------ Process requests
1371: while (my $userinput=<$client>) {
1372: chomp($userinput);
1373: Debug("Request = $userinput\n");
1374: &status('Processing '.$clientname.': '.$userinput);
1375: my $wasenc=0;
1376: alarm(120);
1377: # ------------------------------------------------------------ See if encrypted
1378: if ($userinput =~ /^enc/) {
1379: if ($cipher) {
1380: my ($cmd,$cmdlength,$encinput)=split(/:/,$userinput);
1381: $userinput='';
1382: for (my $encidx=0;$encidx<length($encinput);$encidx+=16) {
1383: $userinput.=
1384: $cipher->decrypt(
1385: pack("H16",substr($encinput,$encidx,16))
1386: );
1387: }
1388: $userinput=substr($userinput,0,$cmdlength);
1389: $wasenc=1;
1390: }
1391: }
1392:
1393: # ------------------------------------------------------------- Normal commands
1394: # ------------------------------------------------------------------------ ping
1395: if ($userinput =~ /^ping/) { # client only
1396: if(isClient) {
1397: print $client "$currenthostid\n";
1398: } else {
1399: Reply($client, "refused\n", $userinput);
1400: }
1401: # ------------------------------------------------------------------------ pong
1402: }elsif ($userinput =~ /^pong/) { # client only
1403: if(isClient) {
1404: my $reply=&reply("ping",$clientname);
1405: print $client "$currenthostid:$reply\n";
1406: } else {
1407: Reply($client, "refused\n", $userinput);
1408: }
1409: # ------------------------------------------------------------------------ ekey
1410: } elsif ($userinput =~ /^ekey/) { # ok for both clients & mgrs
1411: my $buildkey=time.$$.int(rand 100000);
1412: $buildkey=~tr/1-6/A-F/;
1413: $buildkey=int(rand 100000).$buildkey.int(rand 100000);
1414: my $key=$currenthostid.$clientname;
1415: $key=~tr/a-z/A-Z/;
1416: $key=~tr/G-P/0-9/;
1417: $key=~tr/Q-Z/0-9/;
1418: $key=$key.$buildkey.$key.$buildkey.$key.$buildkey;
1419: $key=substr($key,0,32);
1420: my $cipherkey=pack("H32",$key);
1421: $cipher=new IDEA $cipherkey;
1422: print $client "$buildkey\n";
1423: # ------------------------------------------------------------------------ load
1424: } elsif ($userinput =~ /^load/) { # client only
1425: if (isClient) {
1426: my $loadavg;
1427: {
1428: my $loadfile=IO::File->new('/proc/loadavg');
1429: $loadavg=<$loadfile>;
1430: }
1431: $loadavg =~ s/\s.*//g;
1432: my $loadpercent=100*$loadavg/$perlvar{'lonLoadLim'};
1433: print $client "$loadpercent\n";
1434: } else {
1435: Reply($client, "refused\n", $userinput);
1436:
1437: }
1438: # -------------------------------------------------------------------- userload
1439: } elsif ($userinput =~ /^userload/) { # client only
1440: if(isClient) {
1441: my $userloadpercent=&userload();
1442: print $client "$userloadpercent\n";
1443: } else {
1444: Reply($client, "refused\n", $userinput);
1445:
1446: }
1447: #
1448: # Transactions requiring encryption:
1449: #
1450: # ----------------------------------------------------------------- currentauth
1451: } elsif ($userinput =~ /^currentauth/) {
1452: if (($wasenc==1) && isClient) { # Encoded & client only.
1453: my ($cmd,$udom,$uname)=split(/:/,$userinput);
1454: my $result = GetAuthType($udom, $uname);
1455: if($result eq "nouser") {
1456: print $client "unknown_user\n";
1457: }
1458: else {
1459: print $client "$result\n"
1460: }
1461: } else {
1462: Reply($client, "refused\n", $userinput);
1463:
1464: }
1465: #--------------------------------------------------------------------- pushfile
1466: } elsif($userinput =~ /^pushfile/) { # encoded & manager.
1467: if(($wasenc == 1) && isManager) {
1468: my $cert = GetCertificate($userinput);
1469: if(ValidManager($cert)) {
1470: my $reply = PushFile($userinput);
1471: print $client "$reply\n";
1472: } else {
1473: print $client "refused\n";
1474: }
1475: } else {
1476: Reply($client, "refused\n", $userinput);
1477:
1478: }
1479: #--------------------------------------------------------------------- reinit
1480: } elsif($userinput =~ /^reinit/) { # Encoded and manager
1481: if (($wasenc == 1) && isManager) {
1482: my $cert = GetCertificate($userinput);
1483: if(ValidManager($cert)) {
1484: chomp($userinput);
1485: my $reply = ReinitProcess($userinput);
1486: print $client "$reply\n";
1487: } else {
1488: print $client "refused\n";
1489: }
1490: } else {
1491: Reply($client, "refused\n", $userinput);
1492: }
1493: #------------------------------------------------------------------------- edit
1494: } elsif ($userinput =~ /^edit/) { # encoded and manager:
1495: if(($wasenc ==1) && (isManager)) {
1496: my $cert = GetCertificate($userinput);
1497: if(ValidManager($cert)) {
1498: my($command, $filetype, $script) = split(/:/, $userinput);
1499: if (($filetype eq "hosts") || ($filetype eq "domain")) {
1500: if($script ne "") {
1501: Reply($client, EditFile($userinput));
1502: } else {
1503: Reply($client,"refused\n",$userinput);
1504: }
1505: } else {
1506: Reply($client,"refused\n",$userinput);
1507: }
1508: } else {
1509: Reply($client,"refused\n",$userinput);
1510: }
1511: } else {
1512: Reply($client,"refused\n",$userinput);
1513: }
1514: # ------------------------------------------------------------------------ auth
1515: } elsif ($userinput =~ /^auth/) { # Encoded and client only.
1516: if (($wasenc==1) && isClient) {
1517: my ($cmd,$udom,$uname,$upass)=split(/:/,$userinput);
1518: chomp($upass);
1519: $upass=unescape($upass);
1520: my $proname=propath($udom,$uname);
1521: my $passfilename="$proname/passwd";
1522: if (-e $passfilename) {
1523: my $pf = IO::File->new($passfilename);
1524: my $realpasswd=<$pf>;
1525: chomp($realpasswd);
1526: my ($howpwd,$contentpwd)=split(/:/,$realpasswd);
1527: my $pwdcorrect=0;
1528: if ($howpwd eq 'internal') {
1529: &Debug("Internal auth");
1530: $pwdcorrect=
1531: (crypt($upass,$contentpwd) eq $contentpwd);
1532: } elsif ($howpwd eq 'unix') {
1533: &Debug("Unix auth");
1534: if((getpwnam($uname))[1] eq "") { #no such user!
1535: $pwdcorrect = 0;
1536: } else {
1537: $contentpwd=(getpwnam($uname))[1];
1538: my $pwauth_path="/usr/local/sbin/pwauth";
1539: unless ($contentpwd eq 'x') {
1540: $pwdcorrect=
1541: (crypt($upass,$contentpwd) eq
1542: $contentpwd);
1543: }
1544:
1545: elsif (-e $pwauth_path) {
1546: open PWAUTH, "|$pwauth_path" or
1547: die "Cannot invoke authentication";
1548: print PWAUTH "$uname\n$upass\n";
1549: close PWAUTH;
1550: $pwdcorrect=!$?;
1551: }
1552: }
1553: } elsif ($howpwd eq 'krb4') {
1554: my $null=pack("C",0);
1555: unless ($upass=~/$null/) {
1556: my $krb4_error = &Authen::Krb4::get_pw_in_tkt
1557: ($uname,"",$contentpwd,'krbtgt',
1558: $contentpwd,1,$upass);
1559: if (!$krb4_error) {
1560: $pwdcorrect = 1;
1561: } else {
1562: $pwdcorrect=0;
1563: # log error if it is not a bad password
1564: if ($krb4_error != 62) {
1565: &logthis('krb4:'.$uname.','.$contentpwd.','.
1566: &Authen::Krb4::get_err_txt($Authen::Krb4::error));
1567: }
1568: }
1569: }
1570: } elsif ($howpwd eq 'krb5') {
1571: my $null=pack("C",0);
1572: unless ($upass=~/$null/) {
1573: my $krbclient=&Authen::Krb5::parse_name($uname.'@'.$contentpwd);
1574: my $krbservice="krbtgt/".$contentpwd."\@".$contentpwd;
1575: my $krbserver=&Authen::Krb5::parse_name($krbservice);
1576: my $credentials=&Authen::Krb5::cc_default();
1577: $credentials->initialize($krbclient);
1578: my $krbreturn =
1579: &Authen::Krb5::get_in_tkt_with_password(
1580: $krbclient,$krbserver,$upass,$credentials);
1581: # unless ($krbreturn) {
1582: # &logthis("Krb5 Error: ".
1583: # &Authen::Krb5::error());
1584: # }
1585: $pwdcorrect = ($krbreturn == 1);
1586: } else { $pwdcorrect=0; }
1587: } elsif ($howpwd eq 'localauth') {
1588: $pwdcorrect=&localauth::localauth($uname,$upass,
1589: $contentpwd);
1590: }
1591: if ($pwdcorrect) {
1592: print $client "authorized\n";
1593: } else {
1594: print $client "non_authorized\n";
1595: }
1596: } else {
1597: print $client "unknown_user\n";
1598: }
1599: } else {
1600: Reply($client, "refused\n", $userinput);
1601:
1602: }
1603: # ---------------------------------------------------------------------- passwd
1604: } elsif ($userinput =~ /^passwd/) { # encoded and client
1605: if (($wasenc==1) && isClient) {
1606: my
1607: ($cmd,$udom,$uname,$upass,$npass)=split(/:/,$userinput);
1608: chomp($npass);
1609: $upass=&unescape($upass);
1610: $npass=&unescape($npass);
1611: &Debug("Trying to change password for $uname");
1612: my $proname=propath($udom,$uname);
1613: my $passfilename="$proname/passwd";
1614: if (-e $passfilename) {
1615: my $realpasswd;
1616: { my $pf = IO::File->new($passfilename);
1617: $realpasswd=<$pf>; }
1618: chomp($realpasswd);
1619: my ($howpwd,$contentpwd)=split(/:/,$realpasswd);
1620: if ($howpwd eq 'internal') {
1621: &Debug("internal auth");
1622: if (crypt($upass,$contentpwd) eq $contentpwd) {
1623: my $salt=time;
1624: $salt=substr($salt,6,2);
1625: my $ncpass=crypt($npass,$salt);
1626: {
1627: my $pf;
1628: if ($pf = IO::File->new(">$passfilename")) {
1629: print $pf "internal:$ncpass\n";
1630: &logthis("Result of password change for $uname: pwchange_success");
1631: print $client "ok\n";
1632: } else {
1633: &logthis("Unable to open $uname passwd to change password");
1634: print $client "non_authorized\n";
1635: }
1636: }
1637:
1638: } else {
1639: print $client "non_authorized\n";
1640: }
1641: } elsif ($howpwd eq 'unix') {
1642: # Unix means we have to access /etc/password
1643: # one way or another.
1644: # First: Make sure the current password is
1645: # correct
1646: &Debug("auth is unix");
1647: $contentpwd=(getpwnam($uname))[1];
1648: my $pwdcorrect = "0";
1649: my $pwauth_path="/usr/local/sbin/pwauth";
1650: unless ($contentpwd eq 'x') {
1651: $pwdcorrect=
1652: (crypt($upass,$contentpwd) eq $contentpwd);
1653: } elsif (-e $pwauth_path) {
1654: open PWAUTH, "|$pwauth_path" or
1655: die "Cannot invoke authentication";
1656: print PWAUTH "$uname\n$upass\n";
1657: close PWAUTH;
1658: &Debug("exited pwauth with $? ($uname,$upass) ");
1659: $pwdcorrect=($? == 0);
1660: }
1661: if ($pwdcorrect) {
1662: my $execdir=$perlvar{'lonDaemons'};
1663: &Debug("Opening lcpasswd pipeline");
1664: my $pf = IO::File->new("|$execdir/lcpasswd > $perlvar{'lonDaemons'}/logs/lcpasswd.log");
1665: print $pf "$uname\n$npass\n$npass\n";
1666: close $pf;
1667: my $err = $?;
1668: my $result = ($err>0 ? 'pwchange_failure'
1669: : 'ok');
1670: &logthis("Result of password change for $uname: ".
1671: &lcpasswdstrerror($?));
1672: print $client "$result\n";
1673: } else {
1674: print $client "non_authorized\n";
1675: }
1676: } else {
1677: print $client "auth_mode_error\n";
1678: }
1679: } else {
1680: print $client "unknown_user\n";
1681: }
1682: } else {
1683: Reply($client, "refused\n", $userinput);
1684:
1685: }
1686: # -------------------------------------------------------------------- makeuser
1687: } elsif ($userinput =~ /^makeuser/) { # encoded and client.
1688: &Debug("Make user received");
1689: my $oldumask=umask(0077);
1690: if (($wasenc==1) && isClient) {
1691: my
1692: ($cmd,$udom,$uname,$umode,$npass)=split(/:/,$userinput);
1693: &Debug("cmd =".$cmd." $udom =".$udom.
1694: " uname=".$uname);
1695: chomp($npass);
1696: $npass=&unescape($npass);
1697: my $proname=propath($udom,$uname);
1698: my $passfilename="$proname/passwd";
1699: &Debug("Password file created will be:".
1700: $passfilename);
1701: if (-e $passfilename) {
1702: print $client "already_exists\n";
1703: } elsif ($udom ne $currentdomainid) {
1704: print $client "not_right_domain\n";
1705: } else {
1706: my @fpparts=split(/\//,$proname);
1707: my $fpnow=$fpparts[0].'/'.$fpparts[1].'/'.$fpparts[2];
1708: my $fperror='';
1709: for (my $i=3;$i<=$#fpparts;$i++) {
1710: $fpnow.='/'.$fpparts[$i];
1711: unless (-e $fpnow) {
1712: unless (mkdir($fpnow,0777)) {
1713: $fperror="error: ".($!+0)
1714: ." mkdir failed while attempting "
1715: ."makeuser";
1716: }
1717: }
1718: }
1719: unless ($fperror) {
1720: my $result=&make_passwd_file($uname, $umode,$npass,
1721: $passfilename);
1722: print $client $result;
1723: } else {
1724: print $client "$fperror\n";
1725: }
1726: }
1727: } else {
1728: Reply($client, "refused\n", $userinput);
1729:
1730: }
1731: umask($oldumask);
1732: # -------------------------------------------------------------- changeuserauth
1733: } elsif ($userinput =~ /^changeuserauth/) { # encoded & client
1734: &Debug("Changing authorization");
1735: if (($wasenc==1) && isClient) {
1736: my
1737: ($cmd,$udom,$uname,$umode,$npass)=split(/:/,$userinput);
1738: chomp($npass);
1739: &Debug("cmd = ".$cmd." domain= ".$udom.
1740: "uname =".$uname." umode= ".$umode);
1741: $npass=&unescape($npass);
1742: my $proname=&propath($udom,$uname);
1743: my $passfilename="$proname/passwd";
1744: if ($udom ne $currentdomainid) {
1745: print $client "not_right_domain\n";
1746: } else {
1747: my $result=&make_passwd_file($uname, $umode,$npass,
1748: $passfilename);
1749: print $client $result;
1750: }
1751: } else {
1752: Reply($client, "refused\n", $userinput);
1753:
1754: }
1755: # ------------------------------------------------------------------------ home
1756: } elsif ($userinput =~ /^home/) { # client clear or encoded
1757: if(isClient) {
1758: my ($cmd,$udom,$uname)=split(/:/,$userinput);
1759: chomp($uname);
1760: my $proname=propath($udom,$uname);
1761: if (-e $proname) {
1762: print $client "found\n";
1763: } else {
1764: print $client "not_found\n";
1765: }
1766: } else {
1767: Reply($client, "refused\n", $userinput);
1768:
1769: }
1770: # ---------------------------------------------------------------------- update
1771: } elsif ($userinput =~ /^update/) { # client clear or encoded.
1772: if(isClient) {
1773: my ($cmd,$fname)=split(/:/,$userinput);
1774: my $ownership=ishome($fname);
1775: if ($ownership eq 'not_owner') {
1776: if (-e $fname) {
1777: my ($dev,$ino,$mode,$nlink,
1778: $uid,$gid,$rdev,$size,
1779: $atime,$mtime,$ctime,
1780: $blksize,$blocks)=stat($fname);
1781: my $now=time;
1782: my $since=$now-$atime;
1783: if ($since>$perlvar{'lonExpire'}) {
1784: my $reply=
1785: &reply("unsub:$fname","$clientname");
1786: unlink("$fname");
1787: } else {
1788: my $transname="$fname.in.transfer";
1789: my $remoteurl=
1790: &reply("sub:$fname","$clientname");
1791: my $response;
1792: {
1793: my $ua=new LWP::UserAgent;
1794: my $request=new HTTP::Request('GET',"$remoteurl");
1795: $response=$ua->request($request,$transname);
1796: }
1797: if ($response->is_error()) {
1798: unlink($transname);
1799: my $message=$response->status_line;
1800: &logthis(
1801: "LWP GET: $message for $fname ($remoteurl)");
1802: } else {
1803: if ($remoteurl!~/\.meta$/) {
1804: my $ua=new LWP::UserAgent;
1805: my $mrequest=
1806: new HTTP::Request('GET',$remoteurl.'.meta');
1807: my $mresponse=
1808: $ua->request($mrequest,$fname.'.meta');
1809: if ($mresponse->is_error()) {
1810: unlink($fname.'.meta');
1811: }
1812: }
1813: rename($transname,$fname);
1814: }
1815: }
1816: print $client "ok\n";
1817: } else {
1818: print $client "not_found\n";
1819: }
1820: } else {
1821: print $client "rejected\n";
1822: }
1823: } else {
1824: Reply($client, "refused\n", $userinput);
1825:
1826: }
1827: # -------------------------------------- fetch a user file from a remote server
1828: } elsif ($userinput =~ /^fetchuserfile/) { # Client clear or enc.
1829: if(isClient) {
1830: my ($cmd,$fname)=split(/:/,$userinput);
1831: my ($udom,$uname,$ufile) = ($fname =~ m|^([^/]+)/([^/]+)/(.+)$|);
1832: my $udir=propath($udom,$uname).'/userfiles';
1833: unless (-e $udir) { mkdir($udir,0770); }
1834: if (-e $udir) {
1835: $ufile=~s/^[\.\~]+//;
1836: my $path = $udir;
1837: if ($ufile =~m|(.+)/([^/]+)$|) {
1838: my @parts=split('/',$1);
1839: foreach my $part (@parts) {
1840: $path .= '/'.$part;
1841: if ((-e $path)!=1) {
1842: mkdir($path,0770);
1843: }
1844: }
1845: }
1846: my $destname=$udir.'/'.$ufile;
1847: my $transname=$udir.'/'.$ufile.'.in.transit';
1848: my $remoteurl='http://'.$clientip.'/userfiles/'.$fname;
1849: my $response;
1850: {
1851: my $ua=new LWP::UserAgent;
1852: my $request=new HTTP::Request('GET',"$remoteurl");
1853: $response=$ua->request($request,$transname);
1854: }
1855: if ($response->is_error()) {
1856: unlink($transname);
1857: my $message=$response->status_line;
1858: &logthis("LWP GET: $message for $fname ($remoteurl)");
1859: print $client "failed\n";
1860: } else {
1861: if (!rename($transname,$destname)) {
1862: &logthis("Unable to move $transname to $destname");
1863: unlink($transname);
1864: print $client "failed\n";
1865: } else {
1866: print $client "ok\n";
1867: }
1868: }
1869: } else {
1870: print $client "not_home\n";
1871: }
1872: } else {
1873: Reply($client, "refused\n", $userinput);
1874: }
1875: # --------------------------------------------------------- remove a user file
1876: } elsif ($userinput =~ /^removeuserfile/) { # Client clear or enc.
1877: if(isClient) {
1878: my ($cmd,$fname)=split(/:/,$userinput);
1879: my ($udom,$uname,$ufile) = ($fname =~ m|^([^/]+)/([^/]+)/(.+)$|);
1880: &logthis("$udom - $uname - $ufile");
1881: if ($ufile =~m|/\.\./|) {
1882: # any files paths with /../ in them refuse
1883: # to deal with
1884: print $client "refused\n";
1885: } else {
1886: my $udir=propath($udom,$uname);
1887: if (-e $udir) {
1888: my $file=$udir.'/userfiles/'.$ufile;
1889: if (-e $file) {
1890: unlink($file);
1891: if (-e $file) {
1892: print $client "failed\n";
1893: } else {
1894: print $client "ok\n";
1895: }
1896: } else {
1897: print $client "not_found\n";
1898: }
1899: } else {
1900: print $client "not_home\n";
1901: }
1902: }
1903: } else {
1904: Reply($client, "refused\n", $userinput);
1905: }
1906: # ------------------------------------------ authenticate access to a user file
1907: } elsif ($userinput =~ /^tokenauthuserfile/) { # Client only
1908: if(isClient) {
1909: my ($cmd,$fname,$session)=split(/:/,$userinput);
1910: chomp($session);
1911: my $reply='non_auth';
1912: if (open(ENVIN,$perlvar{'lonIDsDir'}.'/'.
1913: $session.'.id')) {
1914: while (my $line=<ENVIN>) {
1915: if ($line=~ m|userfile\.\Q$fname\E\=|) { $reply='ok'; }
1916: }
1917: close(ENVIN);
1918: print $client $reply."\n";
1919: } else {
1920: print $client "invalid_token\n";
1921: }
1922: } else {
1923: Reply($client, "refused\n", $userinput);
1924:
1925: }
1926: # ----------------------------------------------------------------- unsubscribe
1927: } elsif ($userinput =~ /^unsub/) {
1928: if(isClient) {
1929: my ($cmd,$fname)=split(/:/,$userinput);
1930: if (-e $fname) {
1931: print $client &unsub($fname,$clientip);
1932: } else {
1933: print $client "not_found\n";
1934: }
1935: } else {
1936: Reply($client, "refused\n", $userinput);
1937:
1938: }
1939: # ------------------------------------------------------------------- subscribe
1940: } elsif ($userinput =~ /^sub/) {
1941: if(isClient) {
1942: print $client &subscribe($userinput,$clientip);
1943: } else {
1944: Reply($client, "refused\n", $userinput);
1945:
1946: }
1947: # ------------------------------------------------------------- current version
1948: } elsif ($userinput =~ /^currentversion/) {
1949: if(isClient) {
1950: my ($cmd,$fname)=split(/:/,$userinput);
1951: print $client ¤tversion($fname)."\n";
1952: } else {
1953: Reply($client, "refused\n", $userinput);
1954:
1955: }
1956: # ------------------------------------------------------------------------- log
1957: } elsif ($userinput =~ /^log/) {
1958: if(isClient) {
1959: my ($cmd,$udom,$uname,$what)=split(/:/,$userinput);
1960: chomp($what);
1961: my $proname=propath($udom,$uname);
1962: my $now=time;
1963: {
1964: my $hfh;
1965: if ($hfh=IO::File->new(">>$proname/activity.log")) {
1966: print $hfh "$now:$clientname:$what\n";
1967: print $client "ok\n";
1968: } else {
1969: print $client "error: ".($!+0)
1970: ." IO::File->new Failed "
1971: ."while attempting log\n";
1972: }
1973: }
1974: } else {
1975: Reply($client, "refused\n", $userinput);
1976:
1977: }
1978: # ------------------------------------------------------------------------- put
1979: } elsif ($userinput =~ /^put/) {
1980: if(isClient) {
1981: my ($cmd,$udom,$uname,$namespace,$what)
1982: =split(/:/,$userinput);
1983: $namespace=~s/\//\_/g;
1984: $namespace=~s/\W//g;
1985: if ($namespace ne 'roles') {
1986: chomp($what);
1987: my $proname=propath($udom,$uname);
1988: my $now=time;
1989: unless ($namespace=~/^nohist\_/) {
1990: my $hfh;
1991: if (
1992: $hfh=IO::File->new(">>$proname/$namespace.hist")
1993: ) { print $hfh "P:$now:$what\n"; }
1994: }
1995: my @pairs=split(/\&/,$what);
1996: my %hash;
1997: if (tie(%hash,'GDBM_File',
1998: "$proname/$namespace.db",
1999: &GDBM_WRCREAT(),0640)) {
2000: foreach my $pair (@pairs) {
2001: my ($key,$value)=split(/=/,$pair);
2002: $hash{$key}=$value;
2003: }
2004: if (untie(%hash)) {
2005: print $client "ok\n";
2006: } else {
2007: print $client "error: ".($!+0)
2008: ." untie(GDBM) failed ".
2009: "while attempting put\n";
2010: }
2011: } else {
2012: print $client "error: ".($!)
2013: ." tie(GDBM) Failed ".
2014: "while attempting put\n";
2015: }
2016: } else {
2017: print $client "refused\n";
2018: }
2019: } else {
2020: Reply($client, "refused\n", $userinput);
2021:
2022: }
2023: # ------------------------------------------------------------------- inc
2024: } elsif ($userinput =~ /^inc:/) {
2025: if(isClient) {
2026: my ($cmd,$udom,$uname,$namespace,$what)
2027: =split(/:/,$userinput);
2028: $namespace=~s/\//\_/g;
2029: $namespace=~s/\W//g;
2030: if ($namespace ne 'roles') {
2031: chomp($what);
2032: my $proname=propath($udom,$uname);
2033: my $now=time;
2034: unless ($namespace=~/^nohist\_/) {
2035: my $hfh;
2036: if (
2037: $hfh=IO::File->new(">>$proname/$namespace.hist")
2038: ) { print $hfh "P:$now:$what\n"; }
2039: }
2040: my @pairs=split(/\&/,$what);
2041: my %hash;
2042: if (tie(%hash,'GDBM_File',
2043: "$proname/$namespace.db",
2044: &GDBM_WRCREAT(),0640)) {
2045: foreach my $pair (@pairs) {
2046: my ($key,$value)=split(/=/,$pair);
2047: # We could check that we have a number...
2048: if (! defined($value) || $value eq '') {
2049: $value = 1;
2050: }
2051: $hash{$key}+=$value;
2052: }
2053: if (untie(%hash)) {
2054: print $client "ok\n";
2055: } else {
2056: print $client "error: ".($!+0)
2057: ." untie(GDBM) failed ".
2058: "while attempting inc\n";
2059: }
2060: } else {
2061: print $client "error: ".($!)
2062: ." tie(GDBM) Failed ".
2063: "while attempting inc\n";
2064: }
2065: } else {
2066: print $client "refused\n";
2067: }
2068: } else {
2069: Reply($client, "refused\n", $userinput);
2070:
2071: }
2072: # -------------------------------------------------------------------- rolesput
2073: } elsif ($userinput =~ /^rolesput/) {
2074: if(isClient) {
2075: &Debug("rolesput");
2076: if ($wasenc==1) {
2077: my ($cmd,$exedom,$exeuser,$udom,$uname,$what)
2078: =split(/:/,$userinput);
2079: &Debug("cmd = ".$cmd." exedom= ".$exedom.
2080: "user = ".$exeuser." udom=".$udom.
2081: "what = ".$what);
2082: my $namespace='roles';
2083: chomp($what);
2084: my $proname=propath($udom,$uname);
2085: my $now=time;
2086: {
2087: my $hfh;
2088: if (
2089: $hfh=IO::File->new(">>$proname/$namespace.hist")
2090: ) {
2091: print $hfh "P:$now:$exedom:$exeuser:$what\n";
2092: }
2093: }
2094: my @pairs=split(/\&/,$what);
2095: my %hash;
2096: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_WRCREAT(),0640)) {
2097: foreach my $pair (@pairs) {
2098: my ($key,$value)=split(/=/,$pair);
2099: &ManagePermissions($key, $udom, $uname,
2100: &GetAuthType( $udom,
2101: $uname));
2102: $hash{$key}=$value;
2103: }
2104: if (untie(%hash)) {
2105: print $client "ok\n";
2106: } else {
2107: print $client "error: ".($!+0)
2108: ." untie(GDBM) Failed ".
2109: "while attempting rolesput\n";
2110: }
2111: } else {
2112: print $client "error: ".($!+0)
2113: ." tie(GDBM) Failed ".
2114: "while attempting rolesput\n";
2115: }
2116: } else {
2117: print $client "refused\n";
2118: }
2119: } else {
2120: Reply($client, "refused\n", $userinput);
2121:
2122: }
2123: # -------------------------------------------------------------------- rolesdel
2124: } elsif ($userinput =~ /^rolesdel/) {
2125: if(isClient) {
2126: &Debug("rolesdel");
2127: if ($wasenc==1) {
2128: my ($cmd,$exedom,$exeuser,$udom,$uname,$what)
2129: =split(/:/,$userinput);
2130: &Debug("cmd = ".$cmd." exedom= ".$exedom.
2131: "user = ".$exeuser." udom=".$udom.
2132: "what = ".$what);
2133: my $namespace='roles';
2134: chomp($what);
2135: my $proname=propath($udom,$uname);
2136: my $now=time;
2137: {
2138: my $hfh;
2139: if (
2140: $hfh=IO::File->new(">>$proname/$namespace.hist")
2141: ) {
2142: print $hfh "D:$now:$exedom:$exeuser:$what\n";
2143: }
2144: }
2145: my @rolekeys=split(/\&/,$what);
2146: my %hash;
2147: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_WRCREAT(),0640)) {
2148: foreach my $key (@rolekeys) {
2149: delete $hash{$key};
2150: }
2151: if (untie(%hash)) {
2152: print $client "ok\n";
2153: } else {
2154: print $client "error: ".($!+0)
2155: ." untie(GDBM) Failed ".
2156: "while attempting rolesdel\n";
2157: }
2158: } else {
2159: print $client "error: ".($!+0)
2160: ." tie(GDBM) Failed ".
2161: "while attempting rolesdel\n";
2162: }
2163: } else {
2164: print $client "refused\n";
2165: }
2166: } else {
2167: Reply($client, "refused\n", $userinput);
2168:
2169: }
2170: # ------------------------------------------------------------------------- get
2171: } elsif ($userinput =~ /^get/) {
2172: if(isClient) {
2173: my ($cmd,$udom,$uname,$namespace,$what)
2174: =split(/:/,$userinput);
2175: $namespace=~s/\//\_/g;
2176: $namespace=~s/\W//g;
2177: chomp($what);
2178: my @queries=split(/\&/,$what);
2179: my $proname=propath($udom,$uname);
2180: my $qresult='';
2181: my %hash;
2182: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_READER(),0640)) {
2183: for (my $i=0;$i<=$#queries;$i++) {
2184: $qresult.="$hash{$queries[$i]}&";
2185: }
2186: if (untie(%hash)) {
2187: $qresult=~s/\&$//;
2188: print $client "$qresult\n";
2189: } else {
2190: print $client "error: ".($!+0)
2191: ." untie(GDBM) Failed ".
2192: "while attempting get\n";
2193: }
2194: } else {
2195: if ($!+0 == 2) {
2196: print $client "error:No such file or ".
2197: "GDBM reported bad block error\n";
2198: } else {
2199: print $client "error: ".($!+0)
2200: ." tie(GDBM) Failed ".
2201: "while attempting get\n";
2202: }
2203: }
2204: } else {
2205: Reply($client, "refused\n", $userinput);
2206:
2207: }
2208: # ------------------------------------------------------------------------ eget
2209: } elsif ($userinput =~ /^eget/) {
2210: if (isClient) {
2211: my ($cmd,$udom,$uname,$namespace,$what)
2212: =split(/:/,$userinput);
2213: $namespace=~s/\//\_/g;
2214: $namespace=~s/\W//g;
2215: chomp($what);
2216: my @queries=split(/\&/,$what);
2217: my $proname=propath($udom,$uname);
2218: my $qresult='';
2219: my %hash;
2220: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_READER(),0640)) {
2221: for (my $i=0;$i<=$#queries;$i++) {
2222: $qresult.="$hash{$queries[$i]}&";
2223: }
2224: if (untie(%hash)) {
2225: $qresult=~s/\&$//;
2226: if ($cipher) {
2227: my $cmdlength=length($qresult);
2228: $qresult.=" ";
2229: my $encqresult='';
2230: for
2231: (my $encidx=0;$encidx<=$cmdlength;$encidx+=8) {
2232: $encqresult.=
2233: unpack("H16",
2234: $cipher->encrypt(substr($qresult,$encidx,8)));
2235: }
2236: print $client "enc:$cmdlength:$encqresult\n";
2237: } else {
2238: print $client "error:no_key\n";
2239: }
2240: } else {
2241: print $client "error: ".($!+0)
2242: ." untie(GDBM) Failed ".
2243: "while attempting eget\n";
2244: }
2245: } else {
2246: print $client "error: ".($!+0)
2247: ." tie(GDBM) Failed ".
2248: "while attempting eget\n";
2249: }
2250: } else {
2251: Reply($client, "refused\n", $userinput);
2252:
2253: }
2254: # ------------------------------------------------------------------------- del
2255: } elsif ($userinput =~ /^del/) {
2256: if(isClient) {
2257: my ($cmd,$udom,$uname,$namespace,$what)
2258: =split(/:/,$userinput);
2259: $namespace=~s/\//\_/g;
2260: $namespace=~s/\W//g;
2261: chomp($what);
2262: my $proname=propath($udom,$uname);
2263: my $now=time;
2264: unless ($namespace=~/^nohist\_/) {
2265: my $hfh;
2266: if (
2267: $hfh=IO::File->new(">>$proname/$namespace.hist")
2268: ) { print $hfh "D:$now:$what\n"; }
2269: }
2270: my @keys=split(/\&/,$what);
2271: my %hash;
2272: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_WRCREAT(),0640)) {
2273: foreach my $key (@keys) {
2274: delete($hash{$key});
2275: }
2276: if (untie(%hash)) {
2277: print $client "ok\n";
2278: } else {
2279: print $client "error: ".($!+0)
2280: ." untie(GDBM) Failed ".
2281: "while attempting del\n";
2282: }
2283: } else {
2284: print $client "error: ".($!+0)
2285: ." tie(GDBM) Failed ".
2286: "while attempting del\n";
2287: }
2288: } else {
2289: Reply($client, "refused\n", $userinput);
2290:
2291: }
2292: # ------------------------------------------------------------------------ keys
2293: } elsif ($userinput =~ /^keys/) {
2294: if(isClient) {
2295: my ($cmd,$udom,$uname,$namespace)
2296: =split(/:/,$userinput);
2297: $namespace=~s/\//\_/g;
2298: $namespace=~s/\W//g;
2299: my $proname=propath($udom,$uname);
2300: my $qresult='';
2301: my %hash;
2302: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_READER(),0640)) {
2303: foreach my $key (keys %hash) {
2304: $qresult.="$key&";
2305: }
2306: if (untie(%hash)) {
2307: $qresult=~s/\&$//;
2308: print $client "$qresult\n";
2309: } else {
2310: print $client "error: ".($!+0)
2311: ." untie(GDBM) Failed ".
2312: "while attempting keys\n";
2313: }
2314: } else {
2315: print $client "error: ".($!+0)
2316: ." tie(GDBM) Failed ".
2317: "while attempting keys\n";
2318: }
2319: } else {
2320: Reply($client, "refused\n", $userinput);
2321:
2322: }
2323: # ----------------------------------------------------------------- dumpcurrent
2324: } elsif ($userinput =~ /^currentdump/) {
2325: if (isClient) {
2326: my ($cmd,$udom,$uname,$namespace)
2327: =split(/:/,$userinput);
2328: $namespace=~s/\//\_/g;
2329: $namespace=~s/\W//g;
2330: my $qresult='';
2331: my $proname=propath($udom,$uname);
2332: my %hash;
2333: if (tie(%hash,'GDBM_File',
2334: "$proname/$namespace.db",
2335: &GDBM_READER(),0640)) {
2336: # Structure of %data:
2337: # $data{$symb}->{$parameter}=$value;
2338: # $data{$symb}->{'v.'.$parameter}=$version;
2339: # since $parameter will be unescaped, we do not
2340: # have to worry about silly parameter names...
2341: my %data = ();
2342: while (my ($key,$value) = each(%hash)) {
2343: my ($v,$symb,$param) = split(/:/,$key);
2344: next if ($v eq 'version' || $symb eq 'keys');
2345: next if (exists($data{$symb}) &&
2346: exists($data{$symb}->{$param}) &&
2347: $data{$symb}->{'v.'.$param} > $v);
2348: $data{$symb}->{$param}=$value;
2349: $data{$symb}->{'v.'.$param}=$v;
2350: }
2351: if (untie(%hash)) {
2352: while (my ($symb,$param_hash) = each(%data)) {
2353: while(my ($param,$value) = each (%$param_hash)){
2354: next if ($param =~ /^v\./);
2355: $qresult.=$symb.':'.$param.'='.$value.'&';
2356: }
2357: }
2358: chop($qresult);
2359: print $client "$qresult\n";
2360: } else {
2361: print $client "error: ".($!+0)
2362: ." untie(GDBM) Failed ".
2363: "while attempting currentdump\n";
2364: }
2365: } else {
2366: print $client "error: ".($!+0)
2367: ." tie(GDBM) Failed ".
2368: "while attempting currentdump\n";
2369: }
2370: } else {
2371: Reply($client, "refused\n", $userinput);
2372: }
2373: # ------------------------------------------------------------------------ dump
2374: } elsif ($userinput =~ /^dump/) {
2375: if(isClient) {
2376: my ($cmd,$udom,$uname,$namespace,$regexp)
2377: =split(/:/,$userinput);
2378: $namespace=~s/\//\_/g;
2379: $namespace=~s/\W//g;
2380: if (defined($regexp)) {
2381: $regexp=&unescape($regexp);
2382: } else {
2383: $regexp='.';
2384: }
2385: my $qresult='';
2386: my $proname=propath($udom,$uname);
2387: my %hash;
2388: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_READER(),0640)) {
2389: while (my ($key,$value) = each(%hash)) {
2390: if ($regexp eq '.') {
2391: $qresult.=$key.'='.$value.'&';
2392: } else {
2393: my $unescapeKey = &unescape($key);
2394: if (eval('$unescapeKey=~/$regexp/')) {
2395: $qresult.="$key=$value&";
2396: }
2397: }
2398: }
2399: if (untie(%hash)) {
2400: chop($qresult);
2401: print $client "$qresult\n";
2402: } else {
2403: print $client "error: ".($!+0)
2404: ." untie(GDBM) Failed ".
2405: "while attempting dump\n";
2406: }
2407: } else {
2408: print $client "error: ".($!+0)
2409: ." tie(GDBM) Failed ".
2410: "while attempting dump\n";
2411: }
2412: } else {
2413: Reply($client, "refused\n", $userinput);
2414:
2415: }
2416: # ----------------------------------------------------------------------- store
2417: } elsif ($userinput =~ /^store/) {
2418: if(isClient) {
2419: my ($cmd,$udom,$uname,$namespace,$rid,$what)
2420: =split(/:/,$userinput);
2421: $namespace=~s/\//\_/g;
2422: $namespace=~s/\W//g;
2423: if ($namespace ne 'roles') {
2424: chomp($what);
2425: my $proname=propath($udom,$uname);
2426: my $now=time;
2427: unless ($namespace=~/^nohist\_/) {
2428: my $hfh;
2429: if (
2430: $hfh=IO::File->new(">>$proname/$namespace.hist")
2431: ) { print $hfh "P:$now:$rid:$what\n"; }
2432: }
2433: my @pairs=split(/\&/,$what);
2434: my %hash;
2435: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_WRCREAT(),0640)) {
2436: my @previouskeys=split(/&/,$hash{"keys:$rid"});
2437: my $key;
2438: $hash{"version:$rid"}++;
2439: my $version=$hash{"version:$rid"};
2440: my $allkeys='';
2441: foreach my $pair (@pairs) {
2442: my ($key,$value)=split(/=/,$pair);
2443: $allkeys.=$key.':';
2444: $hash{"$version:$rid:$key"}=$value;
2445: }
2446: $hash{"$version:$rid:timestamp"}=$now;
2447: $allkeys.='timestamp';
2448: $hash{"$version:keys:$rid"}=$allkeys;
2449: if (untie(%hash)) {
2450: print $client "ok\n";
2451: } else {
2452: print $client "error: ".($!+0)
2453: ." untie(GDBM) Failed ".
2454: "while attempting store\n";
2455: }
2456: } else {
2457: print $client "error: ".($!+0)
2458: ." tie(GDBM) Failed ".
2459: "while attempting store\n";
2460: }
2461: } else {
2462: print $client "refused\n";
2463: }
2464: } else {
2465: Reply($client, "refused\n", $userinput);
2466:
2467: }
2468: # --------------------------------------------------------------------- restore
2469: } elsif ($userinput =~ /^restore/) {
2470: if(isClient) {
2471: my ($cmd,$udom,$uname,$namespace,$rid)
2472: =split(/:/,$userinput);
2473: $namespace=~s/\//\_/g;
2474: $namespace=~s/\W//g;
2475: chomp($rid);
2476: my $proname=propath($udom,$uname);
2477: my $qresult='';
2478: my %hash;
2479: if (tie(%hash,'GDBM_File',"$proname/$namespace.db",&GDBM_READER(),0640)) {
2480: my $version=$hash{"version:$rid"};
2481: $qresult.="version=$version&";
2482: my $scope;
2483: for ($scope=1;$scope<=$version;$scope++) {
2484: my $vkeys=$hash{"$scope:keys:$rid"};
2485: my @keys=split(/:/,$vkeys);
2486: my $key;
2487: $qresult.="$scope:keys=$vkeys&";
2488: foreach $key (@keys) {
2489: $qresult.="$scope:$key=".$hash{"$scope:$rid:$key"}."&";
2490: }
2491: }
2492: if (untie(%hash)) {
2493: $qresult=~s/\&$//;
2494: print $client "$qresult\n";
2495: } else {
2496: print $client "error: ".($!+0)
2497: ." untie(GDBM) Failed ".
2498: "while attempting restore\n";
2499: }
2500: } else {
2501: print $client "error: ".($!+0)
2502: ." tie(GDBM) Failed ".
2503: "while attempting restore\n";
2504: }
2505: } else {
2506: Reply($client, "refused\n", $userinput);
2507:
2508: }
2509: # -------------------------------------------------------------------- chatsend
2510: } elsif ($userinput =~ /^chatsend/) {
2511: if(isClient) {
2512: my ($cmd,$cdom,$cnum,$newpost)=split(/\:/,$userinput);
2513: &chatadd($cdom,$cnum,$newpost);
2514: print $client "ok\n";
2515: } else {
2516: Reply($client, "refused\n", $userinput);
2517:
2518: }
2519: # -------------------------------------------------------------------- chatretr
2520: } elsif ($userinput =~ /^chatretr/) {
2521: if(isClient) {
2522: my
2523: ($cmd,$cdom,$cnum,$udom,$uname)=split(/\:/,$userinput);
2524: my $reply='';
2525: foreach (&getchat($cdom,$cnum,$udom,$uname)) {
2526: $reply.=&escape($_).':';
2527: }
2528: $reply=~s/\:$//;
2529: print $client $reply."\n";
2530: } else {
2531: Reply($client, "refused\n", $userinput);
2532:
2533: }
2534: # ------------------------------------------------------------------- querysend
2535: } elsif ($userinput =~ /^querysend/) {
2536: if(isClient) {
2537: my ($cmd,$query,
2538: $arg1,$arg2,$arg3)=split(/\:/,$userinput);
2539: $query=~s/\n*$//g;
2540: print $client "".
2541: sqlreply("$clientname\&$query".
2542: "\&$arg1"."\&$arg2"."\&$arg3")."\n";
2543: } else {
2544: Reply($client, "refused\n", $userinput);
2545:
2546: }
2547: # ------------------------------------------------------------------ queryreply
2548: } elsif ($userinput =~ /^queryreply/) {
2549: if(isClient) {
2550: my ($cmd,$id,$reply)=split(/:/,$userinput);
2551: my $store;
2552: my $execdir=$perlvar{'lonDaemons'};
2553: if ($store=IO::File->new(">$execdir/tmp/$id")) {
2554: $reply=~s/\&/\n/g;
2555: print $store $reply;
2556: close $store;
2557: my $store2=IO::File->new(">$execdir/tmp/$id.end");
2558: print $store2 "done\n";
2559: close $store2;
2560: print $client "ok\n";
2561: }
2562: else {
2563: print $client "error: ".($!+0)
2564: ." IO::File->new Failed ".
2565: "while attempting queryreply\n";
2566: }
2567: } else {
2568: Reply($client, "refused\n", $userinput);
2569:
2570: }
2571: # ----------------------------------------------------------------- courseidput
2572: } elsif ($userinput =~ /^courseidput/) {
2573: if(isClient) {
2574: my ($cmd,$udom,$what)=split(/:/,$userinput);
2575: chomp($what);
2576: $udom=~s/\W//g;
2577: my $proname=
2578: "$perlvar{'lonUsersDir'}/$udom/nohist_courseids";
2579: my $now=time;
2580: my @pairs=split(/\&/,$what);
2581: my %hash;
2582: if (tie(%hash,'GDBM_File',"$proname.db",&GDBM_WRCREAT(),0640)) {
2583: foreach my $pair (@pairs) {
2584: my ($key,$value)=split(/=/,$pair);
2585: $hash{$key}=$value.':'.$now;
2586: }
2587: if (untie(%hash)) {
2588: print $client "ok\n";
2589: } else {
2590: print $client "error: ".($!+0)
2591: ." untie(GDBM) Failed ".
2592: "while attempting courseidput\n";
2593: }
2594: } else {
2595: print $client "error: ".($!+0)
2596: ." tie(GDBM) Failed ".
2597: "while attempting courseidput\n";
2598: }
2599: } else {
2600: Reply($client, "refused\n", $userinput);
2601:
2602: }
2603: # ---------------------------------------------------------------- courseiddump
2604: } elsif ($userinput =~ /^courseiddump/) {
2605: if(isClient) {
2606: my ($cmd,$udom,$since,$description)
2607: =split(/:/,$userinput);
2608: if (defined($description)) {
2609: $description=&unescape($description);
2610: } else {
2611: $description='.';
2612: }
2613: unless (defined($since)) { $since=0; }
2614: my $qresult='';
2615: my $proname=
2616: "$perlvar{'lonUsersDir'}/$udom/nohist_courseids";
2617: my %hash;
2618: if (tie(%hash,'GDBM_File',"$proname.db",&GDBM_READER(),0640)) {
2619: while (my ($key,$value) = each(%hash)) {
2620: my ($descr,$lasttime)=split(/\:/,$value);
2621: if ($lasttime<$since) { next; }
2622: if ($description eq '.') {
2623: $qresult.=$key.'='.$descr.'&';
2624: } else {
2625: my $unescapeVal = &unescape($descr);
2626: if (eval('$unescapeVal=~/\Q$description\E/i')) {
2627: $qresult.="$key=$descr&";
2628: }
2629: }
2630: }
2631: if (untie(%hash)) {
2632: chop($qresult);
2633: print $client "$qresult\n";
2634: } else {
2635: print $client "error: ".($!+0)
2636: ." untie(GDBM) Failed ".
2637: "while attempting courseiddump\n";
2638: }
2639: } else {
2640: print $client "error: ".($!+0)
2641: ." tie(GDBM) Failed ".
2642: "while attempting courseiddump\n";
2643: }
2644: } else {
2645: Reply($client, "refused\n", $userinput);
2646:
2647: }
2648: # ----------------------------------------------------------------------- idput
2649: } elsif ($userinput =~ /^idput/) {
2650: if(isClient) {
2651: my ($cmd,$udom,$what)=split(/:/,$userinput);
2652: chomp($what);
2653: $udom=~s/\W//g;
2654: my $proname="$perlvar{'lonUsersDir'}/$udom/ids";
2655: my $now=time;
2656: {
2657: my $hfh;
2658: if (
2659: $hfh=IO::File->new(">>$proname.hist")
2660: ) { print $hfh "P:$now:$what\n"; }
2661: }
2662: my @pairs=split(/\&/,$what);
2663: my %hash;
2664: if (tie(%hash,'GDBM_File',"$proname.db",&GDBM_WRCREAT(),0640)) {
2665: foreach my $pair (@pairs) {
2666: my ($key,$value)=split(/=/,$pair);
2667: $hash{$key}=$value;
2668: }
2669: if (untie(%hash)) {
2670: print $client "ok\n";
2671: } else {
2672: print $client "error: ".($!+0)
2673: ." untie(GDBM) Failed ".
2674: "while attempting idput\n";
2675: }
2676: } else {
2677: print $client "error: ".($!+0)
2678: ." tie(GDBM) Failed ".
2679: "while attempting idput\n";
2680: }
2681: } else {
2682: Reply($client, "refused\n", $userinput);
2683:
2684: }
2685: # ----------------------------------------------------------------------- idget
2686: } elsif ($userinput =~ /^idget/) {
2687: if(isClient) {
2688: my ($cmd,$udom,$what)=split(/:/,$userinput);
2689: chomp($what);
2690: $udom=~s/\W//g;
2691: my $proname="$perlvar{'lonUsersDir'}/$udom/ids";
2692: my @queries=split(/\&/,$what);
2693: my $qresult='';
2694: my %hash;
2695: if (tie(%hash,'GDBM_File',"$proname.db",&GDBM_READER(),0640)) {
2696: for (my $i=0;$i<=$#queries;$i++) {
2697: $qresult.="$hash{$queries[$i]}&";
2698: }
2699: if (untie(%hash)) {
2700: $qresult=~s/\&$//;
2701: print $client "$qresult\n";
2702: } else {
2703: print $client "error: ".($!+0)
2704: ." untie(GDBM) Failed ".
2705: "while attempting idget\n";
2706: }
2707: } else {
2708: print $client "error: ".($!+0)
2709: ." tie(GDBM) Failed ".
2710: "while attempting idget\n";
2711: }
2712: } else {
2713: Reply($client, "refused\n", $userinput);
2714:
2715: }
2716: # ---------------------------------------------------------------------- tmpput
2717: } elsif ($userinput =~ /^tmpput/) {
2718: if(isClient) {
2719: my ($cmd,$what)=split(/:/,$userinput);
2720: my $store;
2721: $tmpsnum++;
2722: my $id=$$.'_'.$clientip.'_'.$tmpsnum;
2723: $id=~s/\W/\_/g;
2724: $what=~s/\n//g;
2725: my $execdir=$perlvar{'lonDaemons'};
2726: if ($store=IO::File->new(">$execdir/tmp/$id.tmp")) {
2727: print $store $what;
2728: close $store;
2729: print $client "$id\n";
2730: }
2731: else {
2732: print $client "error: ".($!+0)
2733: ."IO::File->new Failed ".
2734: "while attempting tmpput\n";
2735: }
2736: } else {
2737: Reply($client, "refused\n", $userinput);
2738:
2739: }
2740:
2741: # ---------------------------------------------------------------------- tmpget
2742: } elsif ($userinput =~ /^tmpget/) {
2743: if(isClient) {
2744: my ($cmd,$id)=split(/:/,$userinput);
2745: chomp($id);
2746: $id=~s/\W/\_/g;
2747: my $store;
2748: my $execdir=$perlvar{'lonDaemons'};
2749: if ($store=IO::File->new("$execdir/tmp/$id.tmp")) {
2750: my $reply=<$store>;
2751: print $client "$reply\n";
2752: close $store;
2753: }
2754: else {
2755: print $client "error: ".($!+0)
2756: ."IO::File->new Failed ".
2757: "while attempting tmpget\n";
2758: }
2759: } else {
2760: Reply($client, "refused\n", $userinput);
2761:
2762: }
2763: # ---------------------------------------------------------------------- tmpdel
2764: } elsif ($userinput =~ /^tmpdel/) {
2765: if(isClient) {
2766: my ($cmd,$id)=split(/:/,$userinput);
2767: chomp($id);
2768: $id=~s/\W/\_/g;
2769: my $execdir=$perlvar{'lonDaemons'};
2770: if (unlink("$execdir/tmp/$id.tmp")) {
2771: print $client "ok\n";
2772: } else {
2773: print $client "error: ".($!+0)
2774: ."Unlink tmp Failed ".
2775: "while attempting tmpdel\n";
2776: }
2777: } else {
2778: Reply($client, "refused\n", $userinput);
2779:
2780: }
2781: # -------------------------------------------------------------------------- ls
2782: } elsif ($userinput =~ /^ls/) {
2783: if(isClient) {
2784: my $obs;
2785: my $rights;
2786: my ($cmd,$ulsdir)=split(/:/,$userinput);
2787: my $ulsout='';
2788: my $ulsfn;
2789: if (-e $ulsdir) {
2790: if(-d $ulsdir) {
2791: if (opendir(LSDIR,$ulsdir)) {
2792: while ($ulsfn=readdir(LSDIR)) {
2793: undef $obs, $rights;
2794: my @ulsstats=stat($ulsdir.'/'.$ulsfn);
2795: #We do some obsolete checking here
2796: if(-e $ulsdir.'/'.$ulsfn.".meta") {
2797: open(FILE, $ulsdir.'/'.$ulsfn.".meta");
2798: my @obsolete=<FILE>;
2799: foreach my $obsolete (@obsolete) {
2800: if($obsolete =~ m|(<obsolete>)(on)|) { $obs = 1; }
2801: if($obsolete =~ m|(<copyright>)(default)|) { $rights = 1; }
2802: }
2803: }
2804: $ulsout.=$ulsfn.'&'.join('&',@ulsstats);
2805: if($obs eq '1') { $ulsout.="&1"; }
2806: else { $ulsout.="&0"; }
2807: if($rights eq '1') { $ulsout.="&1:"; }
2808: else { $ulsout.="&0:"; }
2809: }
2810: closedir(LSDIR);
2811: }
2812: } else {
2813: my @ulsstats=stat($ulsdir);
2814: $ulsout.=$ulsfn.'&'.join('&',@ulsstats).':';
2815: }
2816: } else {
2817: $ulsout='no_such_dir';
2818: }
2819: if ($ulsout eq '') { $ulsout='empty'; }
2820: print $client "$ulsout\n";
2821: } else {
2822: Reply($client, "refused\n", $userinput);
2823:
2824: }
2825: # ----------------------------------------------------------------- setannounce
2826: } elsif ($userinput =~ /^setannounce/) {
2827: if (isClient) {
2828: my ($cmd,$announcement)=split(/:/,$userinput);
2829: chomp($announcement);
2830: $announcement=&unescape($announcement);
2831: if (my $store=IO::File->new('>'.$perlvar{'lonDocRoot'}.
2832: '/announcement.txt')) {
2833: print $store $announcement;
2834: close $store;
2835: print $client "ok\n";
2836: } else {
2837: print $client "error: ".($!+0)."\n";
2838: }
2839: } else {
2840: Reply($client, "refused\n", $userinput);
2841:
2842: }
2843: # ------------------------------------------------------------------ Hanging up
2844: } elsif (($userinput =~ /^exit/) ||
2845: ($userinput =~ /^init/)) { # no restrictions.
2846: &logthis(
2847: "Client $clientip ($clientname) hanging up: $userinput");
2848: print $client "bye\n";
2849: $client->shutdown(2); # shutdown the socket forcibly.
2850: $client->close();
2851: last;
2852:
2853: # ---------------------------------- set current host/domain
2854: } elsif ($userinput =~ /^sethost:/) {
2855: if (isClient) {
2856: print $client &sethost($userinput)."\n";
2857: } else {
2858: print $client "refused\n";
2859: }
2860: #---------------------------------- request file (?) version.
2861: } elsif ($userinput =~/^version:/) {
2862: if (isClient) {
2863: print $client &version($userinput)."\n";
2864: } else {
2865: print $client "refused\n";
2866: }
2867: # ------------------------------------------------------------- unknown command
2868:
2869: } else {
2870: # unknown command
2871: print $client "unknown_cmd\n";
2872: }
2873: # -------------------------------------------------------------------- complete
2874: alarm(0);
2875: &status('Listening to '.$clientname);
2876: }
2877: # --------------------------------------------- client unknown or fishy, refuse
2878: } else {
2879: print $client "refused\n";
2880: $client->close();
2881: &logthis("<font color=blue>WARNING: "
2882: ."Rejected client $clientip, closing connection</font>");
2883: }
2884: }
2885:
2886: # =============================================================================
2887:
2888: &logthis("<font color=red>CRITICAL: "
2889: ."Disconnect from $clientip ($clientname)</font>");
2890:
2891:
2892: # this exit is VERY important, otherwise the child will become
2893: # a producer of more and more children, forking yourself into
2894: # process death.
2895: exit;
2896:
2897: }
2898:
2899:
2900: #
2901: # Checks to see if the input roleput request was to set
2902: # an author role. If so, invokes the lchtmldir script to set
2903: # up a correct public_html
2904: # Parameters:
2905: # request - The request sent to the rolesput subchunk.
2906: # We're looking for /domain/_au
2907: # domain - The domain in which the user is having roles doctored.
2908: # user - Name of the user for which the role is being put.
2909: # authtype - The authentication type associated with the user.
2910: #
2911: sub ManagePermissions
2912: {
2913: my $request = shift;
2914: my $domain = shift;
2915: my $user = shift;
2916: my $authtype= shift;
2917:
2918: # See if the request is of the form /$domain/_au
2919: if($request =~ /^(\/$domain\/_au)$/) { # It's an author rolesput...
2920: my $execdir = $perlvar{'lonDaemons'};
2921: my $userhome= "/home/$user" ;
2922: &logthis("system $execdir/lchtmldir $userhome $user $authtype");
2923: system("$execdir/lchtmldir $userhome $user $authtype");
2924: }
2925: }
2926: #
2927: # GetAuthType - Determines the authorization type of a user in a domain.
2928:
2929: # Returns the authorization type or nouser if there is no such user.
2930: #
2931: sub GetAuthType
2932: {
2933: my $domain = shift;
2934: my $user = shift;
2935:
2936: Debug("GetAuthType( $domain, $user ) \n");
2937: my $proname = &propath($domain, $user);
2938: my $passwdfile = "$proname/passwd";
2939: if( -e $passwdfile ) {
2940: my $pf = IO::File->new($passwdfile);
2941: my $realpassword = <$pf>;
2942: chomp($realpassword);
2943: Debug("Password info = $realpassword\n");
2944: my ($authtype, $contentpwd) = split(/:/, $realpassword);
2945: Debug("Authtype = $authtype, content = $contentpwd\n");
2946: my $availinfo = '';
2947: if($authtype eq 'krb4' or $authtype eq 'krb5') {
2948: $availinfo = $contentpwd;
2949: }
2950:
2951: return "$authtype:$availinfo";
2952: }
2953: else {
2954: Debug("Returning nouser");
2955: return "nouser";
2956: }
2957: }
2958:
2959: sub addline {
2960: my ($fname,$hostid,$ip,$newline)=@_;
2961: my $contents;
2962: my $found=0;
2963: my $expr='^'.$hostid.':'.$ip.':';
2964: $expr =~ s/\./\\\./g;
2965: my $sh;
2966: if ($sh=IO::File->new("$fname.subscription")) {
2967: while (my $subline=<$sh>) {
2968: if ($subline !~ /$expr/) {$contents.= $subline;} else {$found=1;}
2969: }
2970: $sh->close();
2971: }
2972: $sh=IO::File->new(">$fname.subscription");
2973: if ($contents) { print $sh $contents; }
2974: if ($newline) { print $sh $newline; }
2975: $sh->close();
2976: return $found;
2977: }
2978:
2979: sub getchat {
2980: my ($cdom,$cname,$udom,$uname)=@_;
2981: my %hash;
2982: my $proname=&propath($cdom,$cname);
2983: my @entries=();
2984: if (tie(%hash,'GDBM_File',"$proname/nohist_chatroom.db",
2985: &GDBM_READER(),0640)) {
2986: @entries=map { $_.':'.$hash{$_} } sort keys %hash;
2987: untie %hash;
2988: }
2989: my @participants=();
2990: my $cutoff=time-60;
2991: if (tie(%hash,'GDBM_File',"$proname/nohist_inchatroom.db",
2992: &GDBM_WRCREAT(),0640)) {
2993: $hash{$uname.':'.$udom}=time;
2994: foreach (sort keys %hash) {
2995: if ($hash{$_}>$cutoff) {
2996: $participants[$#participants+1]='active_participant:'.$_;
2997: }
2998: }
2999: untie %hash;
3000: }
3001: return (@participants,@entries);
3002: }
3003:
3004: sub chatadd {
3005: my ($cdom,$cname,$newchat)=@_;
3006: my %hash;
3007: my $proname=&propath($cdom,$cname);
3008: my @entries=();
3009: my $time=time;
3010: if (tie(%hash,'GDBM_File',"$proname/nohist_chatroom.db",
3011: &GDBM_WRCREAT(),0640)) {
3012: @entries=map { $_.':'.$hash{$_} } sort keys %hash;
3013: my ($lastid)=($entries[$#entries]=~/^(\w+)\:/);
3014: my ($thentime,$idnum)=split(/\_/,$lastid);
3015: my $newid=$time.'_000000';
3016: if ($thentime==$time) {
3017: $idnum=~s/^0+//;
3018: $idnum++;
3019: $idnum=substr('000000'.$idnum,-6,6);
3020: $newid=$time.'_'.$idnum;
3021: }
3022: $hash{$newid}=$newchat;
3023: my $expired=$time-3600;
3024: foreach (keys %hash) {
3025: my ($thistime)=($_=~/(\d+)\_/);
3026: if ($thistime<$expired) {
3027: delete $hash{$_};
3028: }
3029: }
3030: untie %hash;
3031: }
3032: {
3033: my $hfh;
3034: if ($hfh=IO::File->new(">>$proname/chatroom.log")) {
3035: print $hfh "$time:".&unescape($newchat)."\n";
3036: }
3037: }
3038: }
3039:
3040: sub unsub {
3041: my ($fname,$clientip)=@_;
3042: my $result;
3043: my $unsubs = 0; # Number of successful unsubscribes:
3044:
3045:
3046: # An old way subscriptions were handled was to have a
3047: # subscription marker file:
3048:
3049: Debug("Attempting unlink of $fname.$clientname");
3050: if (unlink("$fname.$clientname")) {
3051: $unsubs++; # Successful unsub via marker file.
3052: }
3053:
3054: # The more modern way to do it is to have a subscription list
3055: # file:
3056:
3057: if (-e "$fname.subscription") {
3058: my $found=&addline($fname,$clientname,$clientip,'');
3059: if ($found) {
3060: $unsubs++;
3061: }
3062: }
3063:
3064: # If either or both of these mechanisms succeeded in unsubscribing a
3065: # resource we can return ok:
3066:
3067: if($unsubs) {
3068: $result = "ok\n";
3069: } else {
3070: $result = "not_subscribed\n";
3071: }
3072:
3073: return $result;
3074: }
3075:
3076: sub currentversion {
3077: my $fname=shift;
3078: my $version=-1;
3079: my $ulsdir='';
3080: if ($fname=~/^(.+)\/[^\/]+$/) {
3081: $ulsdir=$1;
3082: }
3083: my ($fnamere1,$fnamere2);
3084: # remove version if already specified
3085: $fname=~s/\.\d+\.(\w+(?:\.meta)*)$/\.$1/;
3086: # get the bits that go before and after the version number
3087: if ( $fname=~/^(.*\.)(\w+(?:\.meta)*)$/ ) {
3088: $fnamere1=$1;
3089: $fnamere2='.'.$2;
3090: }
3091: if (-e $fname) { $version=1; }
3092: if (-e $ulsdir) {
3093: if(-d $ulsdir) {
3094: if (opendir(LSDIR,$ulsdir)) {
3095: my $ulsfn;
3096: while ($ulsfn=readdir(LSDIR)) {
3097: # see if this is a regular file (ignore links produced earlier)
3098: my $thisfile=$ulsdir.'/'.$ulsfn;
3099: unless (-l $thisfile) {
3100: if ($thisfile=~/\Q$fnamere1\E(\d+)\Q$fnamere2\E$/) {
3101: if ($1>$version) { $version=$1; }
3102: }
3103: }
3104: }
3105: closedir(LSDIR);
3106: $version++;
3107: }
3108: }
3109: }
3110: return $version;
3111: }
3112:
3113: sub thisversion {
3114: my $fname=shift;
3115: my $version=-1;
3116: if ($fname=~/\.(\d+)\.\w+(?:\.meta)*$/) {
3117: $version=$1;
3118: }
3119: return $version;
3120: }
3121:
3122: sub subscribe {
3123: my ($userinput,$clientip)=@_;
3124: my $result;
3125: my ($cmd,$fname)=split(/:/,$userinput);
3126: my $ownership=&ishome($fname);
3127: if ($ownership eq 'owner') {
3128: # explitly asking for the current version?
3129: unless (-e $fname) {
3130: my $currentversion=¤tversion($fname);
3131: if (&thisversion($fname)==$currentversion) {
3132: if ($fname=~/^(.+)\.\d+\.(\w+(?:\.meta)*)$/) {
3133: my $root=$1;
3134: my $extension=$2;
3135: symlink($root.'.'.$extension,
3136: $root.'.'.$currentversion.'.'.$extension);
3137: unless ($extension=~/\.meta$/) {
3138: symlink($root.'.'.$extension.'.meta',
3139: $root.'.'.$currentversion.'.'.$extension.'.meta');
3140: }
3141: }
3142: }
3143: }
3144: if (-e $fname) {
3145: if (-d $fname) {
3146: $result="directory\n";
3147: } else {
3148: if (-e "$fname.$clientname") {&unsub($fname,$clientip);}
3149: my $now=time;
3150: my $found=&addline($fname,$clientname,$clientip,
3151: "$clientname:$clientip:$now\n");
3152: if ($found) { $result="$fname\n"; }
3153: # if they were subscribed to only meta data, delete that
3154: # subscription, when you subscribe to a file you also get
3155: # the metadata
3156: unless ($fname=~/\.meta$/) { &unsub("$fname.meta",$clientip); }
3157: $fname=~s/\/home\/httpd\/html\/res/raw/;
3158: $fname="http://$thisserver/".$fname;
3159: $result="$fname\n";
3160: }
3161: } else {
3162: $result="not_found\n";
3163: }
3164: } else {
3165: $result="rejected\n";
3166: }
3167: return $result;
3168: }
3169:
3170: sub make_passwd_file {
3171: my ($uname, $umode,$npass,$passfilename)=@_;
3172: my $result="ok\n";
3173: if ($umode eq 'krb4' or $umode eq 'krb5') {
3174: {
3175: my $pf = IO::File->new(">$passfilename");
3176: print $pf "$umode:$npass\n";
3177: }
3178: } elsif ($umode eq 'internal') {
3179: my $salt=time;
3180: $salt=substr($salt,6,2);
3181: my $ncpass=crypt($npass,$salt);
3182: {
3183: &Debug("Creating internal auth");
3184: my $pf = IO::File->new(">$passfilename");
3185: print $pf "internal:$ncpass\n";
3186: }
3187: } elsif ($umode eq 'localauth') {
3188: {
3189: my $pf = IO::File->new(">$passfilename");
3190: print $pf "localauth:$npass\n";
3191: }
3192: } elsif ($umode eq 'unix') {
3193: {
3194: #
3195: # Don't allow the creation of privileged accounts!!! that would
3196: # be real bad!!!
3197: #
3198: my $uid = getpwnam($uname);
3199: if((defined $uid) && ($uid == 0)) {
3200: &logthis(">>>Attempted to create privilged account blocked");
3201: return "no_priv_account_error\n";
3202: }
3203:
3204: my $execpath="$perlvar{'lonDaemons'}/"."lcuseradd";
3205: {
3206: &Debug("Executing external: ".$execpath);
3207: &Debug("user = ".$uname.", Password =". $npass);
3208: my $se = IO::File->new("|$execpath > $perlvar{'lonDaemons'}/logs/lcuseradd.log");
3209: print $se "$uname\n";
3210: print $se "$npass\n";
3211: print $se "$npass\n";
3212: }
3213: my $useraddok = $?;
3214: if($useraddok > 0) {
3215: &logthis("Failed lcuseradd: ".&lcuseraddstrerror($useraddok));
3216: }
3217: my $pf = IO::File->new(">$passfilename");
3218: print $pf "unix:\n";
3219: }
3220: } elsif ($umode eq 'none') {
3221: {
3222: my $pf = IO::File->new(">$passfilename");
3223: print $pf "none:\n";
3224: }
3225: } else {
3226: $result="auth_mode_error\n";
3227: }
3228: return $result;
3229: }
3230:
3231: sub sethost {
3232: my ($remotereq) = @_;
3233: my (undef,$hostid)=split(/:/,$remotereq);
3234: if (!defined($hostid)) { $hostid=$perlvar{'lonHostID'}; }
3235: if ($hostip{$perlvar{'lonHostID'}} eq $hostip{$hostid}) {
3236: $currenthostid=$hostid;
3237: $currentdomainid=$hostdom{$hostid};
3238: &logthis("Setting hostid to $hostid, and domain to $currentdomainid");
3239: } else {
3240: &logthis("Requested host id $hostid not an alias of ".
3241: $perlvar{'lonHostID'}." refusing connection");
3242: return 'unable_to_set';
3243: }
3244: return 'ok';
3245: }
3246:
3247: sub version {
3248: my ($userinput)=@_;
3249: $remoteVERSION=(split(/:/,$userinput))[1];
3250: return "version:$VERSION";
3251: }
3252:
3253: #There is a copy of this in lonnet.pm
3254: sub userload {
3255: my $numusers=0;
3256: {
3257: opendir(LONIDS,$perlvar{'lonIDsDir'});
3258: my $filename;
3259: my $curtime=time;
3260: while ($filename=readdir(LONIDS)) {
3261: if ($filename eq '.' || $filename eq '..') {next;}
3262: my ($mtime)=(stat($perlvar{'lonIDsDir'}.'/'.$filename))[9];
3263: if ($curtime-$mtime < 1800) { $numusers++; }
3264: }
3265: closedir(LONIDS);
3266: }
3267: my $userloadpercent=0;
3268: my $maxuserload=$perlvar{'lonUserLoadLim'};
3269: if ($maxuserload) {
3270: $userloadpercent=100*$numusers/$maxuserload;
3271: }
3272: $userloadpercent=sprintf("%.2f",$userloadpercent);
3273: return $userloadpercent;
3274: }
3275:
3276: # ----------------------------------- POD (plain old documentation, CPAN style)
3277:
3278: =head1 NAME
3279:
3280: lond - "LON Daemon" Server (port "LOND" 5663)
3281:
3282: =head1 SYNOPSIS
3283:
3284: Usage: B<lond>
3285:
3286: Should only be run as user=www. This is a command-line script which
3287: is invoked by B<loncron>. There is no expectation that a typical user
3288: will manually start B<lond> from the command-line. (In other words,
3289: DO NOT START B<lond> YOURSELF.)
3290:
3291: =head1 DESCRIPTION
3292:
3293: There are two characteristics associated with the running of B<lond>,
3294: PROCESS MANAGEMENT (starting, stopping, handling child processes)
3295: and SERVER-SIDE ACTIVITIES (password authentication, user creation,
3296: subscriptions, etc). These are described in two large
3297: sections below.
3298:
3299: B<PROCESS MANAGEMENT>
3300:
3301: Preforker - server who forks first. Runs as a daemon. HUPs.
3302: Uses IDEA encryption
3303:
3304: B<lond> forks off children processes that correspond to the other servers
3305: in the network. Management of these processes can be done at the
3306: parent process level or the child process level.
3307:
3308: B<logs/lond.log> is the location of log messages.
3309:
3310: The process management is now explained in terms of linux shell commands,
3311: subroutines internal to this code, and signal assignments:
3312:
3313: =over 4
3314:
3315: =item *
3316:
3317: PID is stored in B<logs/lond.pid>
3318:
3319: This is the process id number of the parent B<lond> process.
3320:
3321: =item *
3322:
3323: SIGTERM and SIGINT
3324:
3325: Parent signal assignment:
3326: $SIG{INT} = $SIG{TERM} = \&HUNTSMAN;
3327:
3328: Child signal assignment:
3329: $SIG{INT} = 'DEFAULT'; (and SIGTERM is DEFAULT also)
3330: (The child dies and a SIGALRM is sent to parent, awaking parent from slumber
3331: to restart a new child.)
3332:
3333: Command-line invocations:
3334: B<kill> B<-s> SIGTERM I<PID>
3335: B<kill> B<-s> SIGINT I<PID>
3336:
3337: Subroutine B<HUNTSMAN>:
3338: This is only invoked for the B<lond> parent I<PID>.
3339: This kills all the children, and then the parent.
3340: The B<lonc.pid> file is cleared.
3341:
3342: =item *
3343:
3344: SIGHUP
3345:
3346: Current bug:
3347: This signal can only be processed the first time
3348: on the parent process. Subsequent SIGHUP signals
3349: have no effect.
3350:
3351: Parent signal assignment:
3352: $SIG{HUP} = \&HUPSMAN;
3353:
3354: Child signal assignment:
3355: none (nothing happens)
3356:
3357: Command-line invocations:
3358: B<kill> B<-s> SIGHUP I<PID>
3359:
3360: Subroutine B<HUPSMAN>:
3361: This is only invoked for the B<lond> parent I<PID>,
3362: This kills all the children, and then the parent.
3363: The B<lond.pid> file is cleared.
3364:
3365: =item *
3366:
3367: SIGUSR1
3368:
3369: Parent signal assignment:
3370: $SIG{USR1} = \&USRMAN;
3371:
3372: Child signal assignment:
3373: $SIG{USR1}= \&logstatus;
3374:
3375: Command-line invocations:
3376: B<kill> B<-s> SIGUSR1 I<PID>
3377:
3378: Subroutine B<USRMAN>:
3379: When invoked for the B<lond> parent I<PID>,
3380: SIGUSR1 is sent to all the children, and the status of
3381: each connection is logged.
3382:
3383: =item *
3384:
3385: SIGUSR2
3386:
3387: Parent Signal assignment:
3388: $SIG{USR2} = \&UpdateHosts
3389:
3390: Child signal assignment:
3391: NONE
3392:
3393:
3394: =item *
3395:
3396: SIGCHLD
3397:
3398: Parent signal assignment:
3399: $SIG{CHLD} = \&REAPER;
3400:
3401: Child signal assignment:
3402: none
3403:
3404: Command-line invocations:
3405: B<kill> B<-s> SIGCHLD I<PID>
3406:
3407: Subroutine B<REAPER>:
3408: This is only invoked for the B<lond> parent I<PID>.
3409: Information pertaining to the child is removed.
3410: The socket port is cleaned up.
3411:
3412: =back
3413:
3414: B<SERVER-SIDE ACTIVITIES>
3415:
3416: Server-side information can be accepted in an encrypted or non-encrypted
3417: method.
3418:
3419: =over 4
3420:
3421: =item ping
3422:
3423: Query a client in the hosts.tab table; "Are you there?"
3424:
3425: =item pong
3426:
3427: Respond to a ping query.
3428:
3429: =item ekey
3430:
3431: Read in encrypted key, make cipher. Respond with a buildkey.
3432:
3433: =item load
3434:
3435: Respond with CPU load based on a computation upon /proc/loadavg.
3436:
3437: =item currentauth
3438:
3439: Reply with current authentication information (only over an
3440: encrypted channel).
3441:
3442: =item auth
3443:
3444: Only over an encrypted channel, reply as to whether a user's
3445: authentication information can be validated.
3446:
3447: =item passwd
3448:
3449: Allow for a password to be set.
3450:
3451: =item makeuser
3452:
3453: Make a user.
3454:
3455: =item passwd
3456:
3457: Allow for authentication mechanism and password to be changed.
3458:
3459: =item home
3460:
3461: Respond to a question "are you the home for a given user?"
3462:
3463: =item update
3464:
3465: Update contents of a subscribed resource.
3466:
3467: =item unsubscribe
3468:
3469: The server is unsubscribing from a resource.
3470:
3471: =item subscribe
3472:
3473: The server is subscribing to a resource.
3474:
3475: =item log
3476:
3477: Place in B<logs/lond.log>
3478:
3479: =item put
3480:
3481: stores hash in namespace
3482:
3483: =item rolesput
3484:
3485: put a role into a user's environment
3486:
3487: =item get
3488:
3489: returns hash with keys from array
3490: reference filled in from namespace
3491:
3492: =item eget
3493:
3494: returns hash with keys from array
3495: reference filled in from namesp (encrypts the return communication)
3496:
3497: =item rolesget
3498:
3499: get a role from a user's environment
3500:
3501: =item del
3502:
3503: deletes keys out of array from namespace
3504:
3505: =item keys
3506:
3507: returns namespace keys
3508:
3509: =item dump
3510:
3511: dumps the complete (or key matching regexp) namespace into a hash
3512:
3513: =item store
3514:
3515: stores hash permanently
3516: for this url; hashref needs to be given and should be a \%hashname; the
3517: remaining args aren't required and if they aren't passed or are '' they will
3518: be derived from the ENV
3519:
3520: =item restore
3521:
3522: returns a hash for a given url
3523:
3524: =item querysend
3525:
3526: Tells client about the lonsql process that has been launched in response
3527: to a sent query.
3528:
3529: =item queryreply
3530:
3531: Accept information from lonsql and make appropriate storage in temporary
3532: file space.
3533:
3534: =item idput
3535:
3536: Defines usernames as corresponding to IDs. (These "IDs" are unique identifiers
3537: for each student, defined perhaps by the institutional Registrar.)
3538:
3539: =item idget
3540:
3541: Returns usernames corresponding to IDs. (These "IDs" are unique identifiers
3542: for each student, defined perhaps by the institutional Registrar.)
3543:
3544: =item tmpput
3545:
3546: Accept and store information in temporary space.
3547:
3548: =item tmpget
3549:
3550: Send along temporarily stored information.
3551:
3552: =item ls
3553:
3554: List part of a user's directory.
3555:
3556: =item pushtable
3557:
3558: Pushes a file in /home/httpd/lonTab directory. Currently limited to:
3559: hosts.tab and domain.tab. The old file is copied to *.tab.backup but
3560: must be restored manually in case of a problem with the new table file.
3561: pushtable requires that the request be encrypted and validated via
3562: ValidateManager. The form of the command is:
3563: enc:pushtable tablename <tablecontents> \n
3564: where pushtable, tablename and <tablecontents> will be encrypted, but \n is a
3565: cleartext newline.
3566:
3567: =item Hanging up (exit or init)
3568:
3569: What to do when a client tells the server that they (the client)
3570: are leaving the network.
3571:
3572: =item unknown command
3573:
3574: If B<lond> is sent an unknown command (not in the list above),
3575: it replys to the client "unknown_cmd".
3576:
3577:
3578: =item UNKNOWN CLIENT
3579:
3580: If the anti-spoofing algorithm cannot verify the client,
3581: the client is rejected (with a "refused" message sent
3582: to the client, and the connection is closed.
3583:
3584: =back
3585:
3586: =head1 PREREQUISITES
3587:
3588: IO::Socket
3589: IO::File
3590: Apache::File
3591: Symbol
3592: POSIX
3593: Crypt::IDEA
3594: LWP::UserAgent()
3595: GDBM_File
3596: Authen::Krb4
3597: Authen::Krb5
3598:
3599: =head1 COREQUISITES
3600:
3601: =head1 OSNAMES
3602:
3603: linux
3604:
3605: =head1 SCRIPT CATEGORIES
3606:
3607: Server/Process
3608:
3609: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to lond CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / loncom