--- loncom/Attic/lonc	2001/11/29 18:57:46	1.22
+++ loncom/Attic/lonc	2001/12/20 17:43:05	1.23
@@ -5,7 +5,7 @@
 # provides persistent TCP connections to the other servers in the network
 # through multiplexed domain sockets
 #
-# $Id: lonc,v 1.22 2001/11/29 18:57:46 www Exp $
+# $Id: lonc,v 1.23 2001/12/20 17:43:05 harris41 Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -39,8 +39,10 @@
 # 2/8,7/25 Gerd Kortemeyer
 # 12/05 Scott Harrison
 # 12/05 Gerd Kortemeyer
+# YEAR=2001
 # 01/10/01 Scott Harrison
 # 03/14/01,03/15,06/12,11/26,11/27,11/28 Gerd Kortemeyer
+# 12/20 Scott Harrison
 # 
 # based on nonforker from Perl Cookbook
 # - server who multiplexes without forking
@@ -143,13 +145,13 @@ sub REAPER {                        # ta
 
 sub HUNTSMAN {                      # signal handler for SIGINT
     local($SIG{CHLD}) = 'IGNORE';   # we're going to kill our children
-    map {
+    foreach (keys %children) {
         $wasserver=$children{$_};
         &status("Closing $wasserver");
         &logthis('Closing '.$wasserver.': '.&subreply('exit',$wasserver));
         &status("Kill PID $_ for $wasserver");
 	kill ('INT',$_);
-    } keys %children;
+    }
     my $execdir=$perlvar{'lonDaemons'};
     unlink("$execdir/logs/lonc.pid");
     &logthis("<font color=red>CRITICAL: Shutting down</font>");
@@ -158,13 +160,13 @@ sub HUNTSMAN {                      # si
 
 sub HUPSMAN {                      # signal handler for SIGHUP
     local($SIG{CHLD}) = 'IGNORE';  # we're going to kill our children
-    map {
+    foreach (keys %children) {
         $wasserver=$children{$_};
         &status("Closing $wasserver");
         &logthis('Closing '.$wasserver.': '.&subreply('exit',$wasserver));
         &status("Kill PID $_ for $wasserver");
 	kill ('INT',$_);
-    } keys %children;
+    }
     &logthis("<font color=red>CRITICAL: Restarting</font>");
     unlink("$execdir/logs/lonc.pid");
     my $execdir=$perlvar{'lonDaemons'};
@@ -175,13 +177,13 @@ sub checkchildren {
     &initnewstatus();
     &logstatus();
     &logthis('Going to check on the children');
-    map {
+    foreach (sort keys %children) {
 	sleep 1;
         unless (kill 'USR1' => $_) {
 	    &logthis ('Child '.$_.' is dead');
             &logstatus($$.' is dead');
         } 
-    } sort keys %children;
+    }
 }
 
 sub USRMAN {
@@ -447,7 +449,7 @@ if ($cipher=new IDEA $cipherkey) {
     @allbuffered=grep /\.$conserver$/, readdir DIRHANDLE;
     closedir(DIRHANDLE);
     my $dfname;
-    map {
+    foreach (@allbuffered) {
         &status("Sending delayed $conserver $_");
         $dfname="$path/$_";
         &logthis($dfname);
@@ -488,7 +490,7 @@ if ($cipher=new IDEA $cipherkey) {
             &logthis("Delayed $cmd to $conserver: >$answer<");
             &logperm("S:$conserver:$bcmd");
         }        
-    } @allbuffered;
+    }
 
 # ------------------------------------------------------- Listen to UNIX socket
 &status("Opening socket $conserver");
@@ -693,3 +695,50 @@ sub nonblock {
             or die "Can't make socket nonblocking: $!\n";
 }
 
+# ----------------------------------- POD (plain old documentation, CPAN style)
+
+=head1 NAME
+
+lonc - LON TCP-MySQL-Server Daemon for handling database requests.
+
+=head1 SYNOPSIS
+
+Should only be run as user=www.  This is a command-line script which
+is invoked by loncron.
+
+=head1 DESCRIPTION
+
+Provides persistent TCP connections to the other servers in the network
+through multiplexed domain sockets
+
+ PID in subdir logs/lonc.pid
+ kill kills
+ HUP restarts
+ USR1 tries to open connections again
+
+=head1 README
+
+Not yet written.
+
+=head1 PREREQUISITES
+
+POSIX
+IO::Socket
+IO::Select
+IO::File
+Socket
+Fcntl
+Tie::RefHash
+Crypt::IDEA
+
+=head1 COREQUISITES
+
+=head1 OSNAMES
+
+linux
+
+=head1 SCRIPT CATEGORIES
+
+Server/Process
+
+=cut