source: trunk/release_notes.v7.1 @ 5054

Revision 2981, 27.0 KB checked in by stefan, 11 years ago (diff)

trabant comments incorporated

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1Release Notes:  Earthworm Version "working"
2Cleaned out after release of v7.0 on 6/15/2006
3This release is EW V7.1 and has all of 7.0 SCNL upgrades.
4
5EW v7.1 released on April 5, 2007
6
7NEW MODULES:
8***********
9
10Added data_exchange/pickwasher, a prerequisite for glass.
11Source from Hydra project, tested and documented by Mitch,
12committed and makefiles cleaned up by Stefan. Makefiles for
13Solaris and Windows only at this point.
14Stefan Lisowski 20070403
15
16Created a 'params' directory at the root level of Earthworm
17containing the .d and .desc files for all modules. Each
18release of earthworm will require updating these files from
19the .src tree.
20Stefan Lisowski 200704
21
22Added in MAC OS X flags to compile on Intel and PPC chip
23sets. This works for all my test modules except, you
24guessed it, hyp2000_mgr which doesn't compile because
25of GNU g77 or gfortran issues.
26One thing you must do for Mac OS X is to increase
27the shared memory segments by adding in a /etc/sysctl.conf
28with these settings:
29        kern.sysv.shmmax=16777216
30        kern.sysv.shmmin=1
31        kern.sysv.shmmni=32
32        kern.sysv.shmseg=16
33        kern.sysv.shmall=4096
34To find out the default settings type this:
35sysctl -a | grep shm
36This work was done jointly by:
37Paul Friberg ISTI and Rae Yip (Caltech) 2007/03/28
38
39Added psn4putaway for PSN4 format  to libsrc/util for
40windows only, and added it to docs, trig2disk and
41waveman2disk .d files and makefile.nt's.
42Paul Friberg 2007/03/05
43
44Added ws2ew and psnadsend for windows for webtronics
45digitzers. These 2 modules were put in data_sources.
46Paul Friberg 2007/03/04
47
48tankplayer_tools/ms2tb - miniSEED to tracebuf converter
49for playing back miniSEED format time-series.
50Paul Friberg 2006/08/08
51
52condense_logo - Reads messages from a list of logos from one
53transport ring and writes them to another ring using its own
54installation and module id in the logo. Menlo Park
55contribution. (included/tested by Stefan 2006/11/22)
56
57
58MODIFICATIONS/BUG FIXES TO EXISTING MODULES:
59********************************************
60
61q3302ew - new version based on lib330! This one
62is a vast improvement over the one based on Mountainair.
63Hal Schechner 2007/04/04
64
65startstop - all flavors, modified MAX_CHILD to 200 (was set
66to 100, probably to limit process usage or memory usage
67by startstop in the early days).
68Paul Friberg 2007/04/03
69
70localmag - 2.1.1
71INGV contributed a feature to write EVENT files in
72SHAKEMAP XML format to the SAC output directory. This optional feature
73is only usable when you also use the saveTrace option.
74Contributed by Matteo Quintiliani and Marco Oliveri of INGV.
75Integrated in with current version by Paul Friberg 2007/03/29
76
77diagnostic_tools/sniffwave
78Earthworm Class March 2007, added statistics flag to sniffwave
79y, n, or s options are now handled, tport function changed
802007/03/23
81
82Many warnings under windows with MS 2005 compiler were
83fixed relating to time related variables using long instead
84of time_t. This had segmentation violations under some
85programs so we decided to fix all of the warnings.
86Here is the list:
87tankplayer, wave_serverV,condenselogo, ringdup, ws_clientIIx.h,
88file2ew, ringtocoax and II, config_ws, gaplist, arc2trig,
89localmag, gmew, pkfilter, statrigfilter
90Paul Friberg 2007/02/23
91
92archiving/trig2disk archiving/waveman2disk Solaris only
93Added Richard Luckett's support for writing miniseed format.
94This added Chad Trabant's libmseed to libsrc/util.
95Another library by Chad Trabant is located at
96data_exchange/slink2ew/libslink as well.
97Note that libmseed and libslink are different libraries.
98Stefan Lisowski 2007/02/20
99
100diagnostic_tools/template - fixed a longstanding bug
101in template where long was used as the time type instead
102of time_t.
103Paul Friberg 2007/02/20
104
105lockfile_ew.c and lockfile.c added to libsrc for file locking
106for earthworm. See the lockfile.h in the include directory for
107the function declarations. Also, see the updated diagnostic_tools/template.c
108for an example of its use. The intent is to use this for
109startstop which should NEVER have more than one instance
110running per startstop_*.d file! This lockfile implementation
111works for both Windows, Linux, and Solaris (tested on each)
112Paul Friberg 2007/02/20
113
114data_sources/scream2ew
115scream2ew - the first call to logit_init needs to have 1 as 4th argument not the undefined config.writelog, otherwise the second call doesn't work.
116Richard Luckett
117committed to CVS by stefan 2007/02/19
118
119archiving/wave_serverV Linux patch
120The following patch is for wave_serverV.c to enable it to be compiled
121under linux (specifically gcc 3.3.6 doesn't seem to recognise the "#else
122if defined(...)" construct properly, at least with the default CFLAGS.
123Matthew van de Werken
124committed to CVS by stefan 2007/02/19
125
126seismic_processing/fir
127I believe I have discovered a bug in earthworm 7.0. It seems there
128is now a 2-byte field called version in the trace header. This is
129never set up in the fir module, so that it outputs packets to the
130transport ring with no valid information in this field. I noticed
131this when I set up a carlstatrig module which kept crashing when
132being fed with data from fir - carlstatrig checks the trace header
133for a valid version. I solved the problem by adding the lines
134   outHead->version[0] = TRACE2_VERSION0;
135   outHead->version[1] = TRACE2_VERSION1;
136to firfilt.c at the point where data is being copied into the
137outgoing packet.
138David Scott. 2006/9/22 (commited to CVS 2006/12/30 stefan)
139
140archiving/tankplayer_tools
141data_exchange/liss
142data_sources/scream2ew
143linux makefile fixes per david J Scott 20060720
144(commited to CVS 2006/12/30 stefan)
145
146libsrc/qlib2 - an old (10 year) version of qlib2 was in data_sources/q2ew
147We now place qlib2 in libsrc. I populated directory libsrc/qlib2
148with the qlib2 from qlib2.tar.2006.313.gz downloaded from
149http://www.ncedc.org/qug/software/ucb/ and commited the src code
150to CVS
151Ilya Dricker 2006/11/16
152
153
154evanstrig
155Fix for linux compilation.
156Laurence Withers, GSL 2006/10/23
157
158carlstatrig
159Michelle Kline of Utah added in STAtime as a configurable
160value (was statically set to 1 in the C code). This configuration
161is backward compatible to the old version and is an optional
162parameter. Michelle kindly updated the documentation too.
163committed to CVS 2006/10/20 Paul Friberg
164
165trig2disk
166Michael Lofgren of CSIRO fixed a log message bug.
167commited to CVS 2006/10/18 Paul Friberg
168
169gaplist:
170Changed gap- binning boundaries from 1.0 to 1.1 sec so that gaps from
1711 second timing errors will show up in a different bin from gaps caused
172by 1 missed packet (for most digital dataloggers). 2007/01/10 Lynn Dietz
173
174hyp2000:
175I grabbed Fred Klein's newest version of hypoinverse where he 
176added the processing domain and version feature. The new command is:
177   VER 'NC' '01'   / Processing domain and version
178Hypoinverse puts these two 2-character strings to the end of summary
179cards and at the top of print files. These six source files were changed:
180   common.inc hycmd.for hysum.for hystl.for hyp.for hybda.for
181committed to CVS 2006/10/30 Lynn Dietz
182PS: someone needs to change hystl.fpp for Linux!!
183  Incorporated Fred Klein's 11/09/2006 version of hyp2000 in which he changed
184the magnitude weight calculation from the sum of weights (float) to the
185count (int) of weighted station magnitudes.
186Committed to CVS 2007/1/4 Lynn Dietz
187  Incorporated Fred Klein's 2/2007 version 1.1 of hyp2000. In this version
188Fred added the option to fix origin time (changes to common.inc, hyloc.for,
189hyp.for, hyphs.for) and did some minor tweaks to make the g77 compiler
190happy (changes to hydelt.f, hyedit.f, hyinp.for, hystl.for).
191I also removed a bunch of source files and .com files which are not
192used in either hyp2000 or hyp2000_mgr under Earthworm.
193Committed to CVS 2007/03/02 Lynn Dietz
194  Incorporated Fred Klein's 3/21/2007 bug fixes. Minor logic changes in
195hyphs.for and hyloc.for related to fixing origin time or depth (which
196can now be fixed at 0.0). The program now does what the documentation
197says it will.  Committed to CVS 2007/03/23 Lynn Dietz
198
199hyp2000_mgr - windows issue
200The ew7.0 version of this for windows did not work properly
201due to a bad pass by value in the link to the fortran code.
202Fixed 2006/10/16 Paul Friberg
203
204arc2trig
205David Scott of the BGS upgrade this to be SCNL compliant. Thanks!
206commited to CVS 2006/10/13 Paul Friberg
207
208startstop_unix_generic.c
209Removed an fprint() from EncodeStatus() which was causing a partially
210completed EW status message to go to stderr after info from each
211child process was added to the status.  I think this was a debugging
212leftover. Lynn Dietz 2006/09/22
213
214gcf2ew
215Modified for TYPE_GCFSOH_PACKET output of SOH packets for SNW monitoring
216of state of health packets from guralps DM24. Same for scream2ew
217Paul Friberg, 2006/09/01
218Modified to correctly put in the TRACEBUF2 version  member values
219Paul Friberg, 2006/11/08
220
221q2ew
222Modified to correctly put in the TRACEBUF2 version  member values
223Ported to and tested on Linux (added makefile.ux support)
224Ilya Dricker, 2006/11/21
225
226scream2ew
227Modified for TYPE_GCFSOH_PACKET output of SOH packets.
228Paul Friberg, 2006/09/01
229Laurence Withers, GSL 2006/10/23 provided linux compilation fix
230
231grab_bag/pick_recorder - made it SCNL compliant and added
232the app to the documentation.
233Paul Friberg 2006/09/01
234
235tankplayer_tools/sac2tb - fixed a minor bug in the TRACE2_HEADER that
236overwrote the version element of the trace header. This bug caused
237tankplayer to barf.
238Paul Friberg 2006/08/08
239
240heli_ewII -- heli_ewII.h
241samp_sec now a float instead of a long to accommodate sample rates
242less than 1 Hz 
243Stefan Lisowski 20060726
244
245scn2scnl -- to_trace_scnl.c/ scn_convert.c
246I've fixed scn2scnl so that it will truncate invalid-length SCNL strings
247and prevent strings from overrunning their bounds.  I've attached the
248files that were changed.  Both of them live in
249src\data_exchange\scn_convert.
250to_trace_scnl.c contains the fix.  The function to_trace_scnl() will now
251force the last character of each SCNL buffer to be null.  This is needed
252because strncpy will not append a null character if the source string used
253during copies is as long or longer than the number of characters to count.
254scn_convert.c has a minor fix where some local variables in s2s_com() were
255declared twice.  I removed the redundant declaration to prevent any future
256headaches.
257Mark Morrison Mon, 26 Jun 2006 15:57:19 -0600 (MDT)
258
259sniffwave -- sniffwave.c
260additional significant digits for sample rates < 1hz
261Stefan Lisowski 20060726
262
263tankplayer -- tankplayer.c
264SendLate command in tankplayer.d did not appear to be working.
265The problem is that while tankplayer will play back 3 waveform types
266(TypeADBuf, TypeTraceBuf, TypeTraceBuf2) it would only set the time
267if the type was one of the first two. Should now work for TraceBuf2 as
268well.
269John Patton (Tested, compiled and added to CVS by Stefan 20060630)
270
271wave_serverV -- wave_serverV.c
272The problem was that the size of the tankfile is not an integer multiple
273of the packet size and so occasionally there is a mess up at the end of
274the file (mine were 3 in this example).  The result was that the data
275requested from the server was not returned and an event file failed to
276be written.
277[Fix was to add an else to wave_serverV_config]
278Richard R Luckett, BGS (Tested, compiled and added to CVS by Stefan 20060711)
279Laurence Withers, GSL provided a fix for linux 10/23/2006
280
281Signals were not being handled at all under linux (which caused SIGPIPE signals
282to take down the server).  I changed some ifdefs around so that the solaris
283signal handling is compiled in under linux as well.
284Hal Schechner
285
286Modified behavior so that client socket-disconnects between requests are no
287longer recorded/logged as socket-errors, even when the server thinks the
288socket was not closed cleanly.  This should get rid of messages like:
289>>>> 20060210_UTC_08:51:22 Wave_serverV:ListenForMsg: Bad socket read.  iReadResult = -1
290which cause people to think an error has occurred.
291Updated server_thread.c timestamp.
292David Kragness 2006/10/09
293
294
295ws_clientIIoc / ws_clientII.h
296Upped the max menu str len (as defined by wsREPLEN) so that it is large
297enough to handle a 5000+ SCNL menu from a single wave_server.
298Downside is that it must temporarily allocate 400kb instead of 80kb when
299parsing a menu.  This seemed like a reasonable tradeoff.
300Added protection against oversized SCNL fields in wave server menus:
301increased the size of the buffers used to capture SCNL values from the
302menu, in order to reduce the chance of clobbering memory if a channel
303with SCNL longer than the spec'd tracebuf2 sizes is found in a menu.
304Fixed a bug where wsGetTraceAsciiL() was returning WS_ERR_NONE even
305though there was a warning flag (with a WS_WRN_FLAGGED) return code
306from wsParseAsciiHeaderReplyL().
307Added a work around for handling flagged wave_server returns where the
308datatype does not get properly filled in.
309DK 061906
310
311eqcoda:
312Modified to read per-channel parameters from more than one "StaFile".
313Final station list is sorted after all station files are input.
314Lynn Dietz 2006/09/20
315Modified to ignore channels in the "StaFile" whose pick flags are
316set to 0. Previously, those lines ended up in total count of channels.
317Lynn Dietz 2007/01/09
318
319pick_ew:
320  Modified to be able to process multiple "StaFile" commands for setting
321per-channel picking parameters. 
322Lynn Dietz 2006/09/20
323  Changed name of index file to pick_ew_XXX.ndx where XXX is the moduleid
324of the current instance of pick_ew. This allows multiple instances of
325pick_ew to run on the same computer without competing for the same
326index file.   
327Lynn Dietz 2006/11/16
328
329wave_viewer:
330Modified to accept sample rates >= 1000hz.
331David Kragness  2006/10/09
332Modified format of left-hand column so that channel naming and other
333information is more compact.
334David Kragness  2006/10/26
335
336sniffwave:
337Now if you give station, channel, network and location codes on command line,
338sniffwave will sniff only for TYPE_TRACEBUF2 and TYPE_TRACE2_COMP_UA
339packets. Or if you give station, channel and network, then sniffwave will
340sniff only for TYPE_TRACEBUF or TYPE_TRACE_COMP_UA. This gives you more
341control over what sniffwave looks for. However, it means you can no long sniff
342for both TYPE_TRACEBUF and TYPE_TRACEBUF2 packets at the same time with a
343single instance of sniffwave.
344Pete Lombard 2006/12/28
345
346scnl2scn:
347Now can perform complete mapping of SCNL names to SCN names, using
348configuration commands similar to those of scn2scnl. This is in place of the
349all-or-nothing approach of the previous scnl2scn.
350Pete Lombard 2006/12/28
351
352scnl2scn:
353Fixed bug in scnl2scn.c: forgot to sort the explicit list.
354Added Debug option to log the configured mapping as well as logging how it
355maps (or not) each SCNL it sees. Very verbose, so run it with Debug on only as
356long as you need it.
357Pete Lombard 2007/01/17
358
359naqsserTG:
360Incorporated Paul Whitmore's most recent code for processing tide gauge
361data from Nanometrics serial data streams. Paul added 5 new arguments
362to his "RequestChannel" command. See sample .d file for details.
363Lynn Dietz 2007/02/09
364
365wftimefilter:
366  Added a sanity check on number of samples in a packet. Packets with
367nsamp <= 0 are rejected. 
368  Modified samplerate comparison to allow for a bit of slop before
369declaring that a samplerate has "changed." This is to allow for the
370case where a datasource is reporting the actual sample rate instead
371of nominal sample rate. 
372  Re-worded the logic of the if() statements which limit the logging
373of bad packets and warnings.
374Lynn Dietz 2007/02/14
375
376CHANGES TO CONFIGURATION FILES and DESCRIPTOR FILES:
377****************************************************
378
379scnl2scn:
380Now requires commands to specify the mapping from SCNL to SCN. The commands
381are very similar to those used by scn2scnl. See the comments in scnl2scn.d
382Pete Lombard 2006/12/28
383
384scnl2scn:
385Added Debug option to log the configured mapping as well as logging how it
386maps (or not) each SCNL it sees. Very verbose, so run it with Debug on only as
387long as you need it.
388Pete Lombard 2007/01/17
389
390 
391KNOWN BUGS:
392***********
393
394liss2ew:
395liss2ew has been observed intermittantly producing malformed
396TRACE_BUF messages.  Currently the conditions for causing this problem
397are unknown.  Due to this, liss2ew should be treated as suspect.  Use at
398your own risk.  JMP 6-18-2003
399
400k2ew:
401k2ew uses the k2hdr.rwParms.misc.channel_bitmap parameter to decide
402which channels it will see as streams from the K2.  This is actually the
403parameter which the K2 uses to decide which channels to record in an event
404file (see K2's <bitmap> command).  The K2's <sdstreams bitmap> is the parameter
405that shows which channels the K2 is streaming out.  This is the parameter
406that k2ew should be using to decide what data it will see.  The big problem
407is that none of the header files from Kinemetrics (nkwhdrs.h) seem to
408show this parameter anywhere. This issue is only a problem for those folks
409who want to record more channels on the K2 than they want to stream continuously.
410Terry Dye (Univ of Utah) discovered this problem when trying to stream only
4113 channels of a 12 channel K2.  LDD 4/11/2002    FIXED PNL, 6/9/03
412
413
414wave_serverV:
415it occasionally sends the following error to statmgr:
416   UTC_Thu Sep 06 03:30:14 2001  WSV1/wave_serverV_nano ReadBlockData
417   failed for tank [z:\nano57.tnk], with offset[999908] and record
418   size[64]! errno[0] Mail sent.
419The nominal tank size is 1 megabyte, and the actual tank size is 999908.
420It looks like waveserver is trying to read off the end of the tank.
421WMK 9/6/01
422
423wave_serverV:
424appears not to reply to requests for a single sample of data. I noticed
425when testing wave_viewer, that if the start time and end time of a request were
426equal (in which case there should be one sample of data) then wave_serverV did
427not reply to the request (ASCII request) at all. No Data, No Flags, No Reply,
428No Nothing.  It needs to issue a reply to every request.
429DavidK 09/25/01
430
431wave_serverV:
432Wave server appears to be limited (on 32-bit systems) to 1GB tank sizes.
433A bug (a signed integer overflow of tmpoE at Line 1155 of
434       serve_trace.c  (LocateRoughOffset()))
435prevents data retrieval from the tank under certain conditions when the
436tank size exceeds 1 GB.
437DavidK & PNL 09/27/04
438
439Automatic restarts of adsend (using the "restartMe" line in the descriptor
440file) can cause an NT system to hang. Therefore, you should never
441use the autorestart feature with adsend, but you should bring down
442the entire Earthworm system if adsend needs to be restarted.
443LDD 5/31/2000 Comments added to adsend.desc, but leave this warning here!
444
445libsrc/utils/site.c: The strings used for station, channel and network are
446required to be fixed length with trailing spaces added to short names. If
447the strings given to site_index do not have these trailing blanks, SCN names
448will not match. This is not documented anywhere.  PNL 10/15/00
449
450socket_ew: (libsrc/util/socket_ew_common.c libsrc/solaris/socket_ew.c
451            libsrc/winnt/socket_ew.c include/socket_ew.h)
452Fixed a bug in the connect_ew function().
453When run in non-blocking mode (clients connecting to
454a server - using a timeout value), there was a bug in
455the connection code(discovered on Solaris) that caused
456the function to return a timeout-error when there was
457any kind of error during connection.
458The bug was discovered when connecting to a non-existent socket.
459When trying to connect to a non-existent wave_server on a machine,
460the underlying socket library was returning a Connection-Refused error,
461but the socket_ew library was passing back a timeout error.
462-
463The change only applies when a socket-error occurs while the function is
464waiting for the connect to happen.  The instance where you will most-likely
465see a difference, is when you try connecting to a non-existent socket.
466Previously the function would return TIMEOUT, now it will return
467connection REFUSED.
468-
469Added a new function: socketSetError_ew(),
470and defined a new socket_ew return code: CONNREFUSED_EW.
471DK 2003/02/04
472
473sm_ew2ora:
474There is a bug in sm_ew2ora that involves having multipe time intervals for
475components and channels.  If a strong motion message containing information
476for a channel that the DB has never seen before is loaded into the DB, and
477then later another message for the same channel with an earlier timestamp
478is loaded, the load of the second message will fail, due to problems with
479overlapping time intervals, and the call that sm_ew2ora uses to create
480those time intervals.  This problem only affects stations that were
481not previously loaded via one of the station loader programs stalist*2ora,
482and only when receiving SM data that is timestamped with a time that is
483prior to the original time for that channel.  The bug lies in the logic
484of ewdb_api_PutSMMessage(), and not in the underlying code.
485Davidk 05/25/01
486
487A change was made to ewdb_api_PutSMMessage() that dramatically affects
488sm_ew2ora.  Please see the note about that function.  Davidk 2001/07/26
489
490ewdb_api_CreateWaveform()  (ewdb_internal_CreateSnippet.c
491                            ewdb_internal_CreateWaveformDesc.c)
492Added a call to release the cursors used by the internal functions, when they
493fail.  Fixes a bug which resulted in a DB cursor leak when a call to stuff
494a snippet into the DB failed.
495DK 2003/02/04
496
497logit.c:
4981) Added a new function logit_core()
499int logit_core( char *flag, char *format, va_list ap);
500This function is the same as logit(), except that it takes a va_list argument
501for the variable length parameter instead of '...', and it has an int
502return value.
503This function can be called by other functions that receive a '...' variable
504argument list, where as logit() cannot.  logit_core() is to logit()
505what vsprintf() is to sprintf().
506-
5072) Moved all of the functionality in logit() to logit_core(), and modify
508logit to call logit_core().
509-
5103)  Added a new function get_prog_name2(), as an intended replacement
511of get_prog_name().  get_prog_name2() includes an additional
512parameter (the buffer length of the output buffer).
513-
5144)  Modified logit_init() to use get_prog_name2() instead of get_prog_name()
515-
516All four(4) of these changes should be backwards compatible with all existing
517earthworm code, and the modified logit.c has already been tested with several
518earthworm modules.
519-
520
521
522ewdb_api:
523Added new function ewdb_api_GetEventSummaryInfo() to retrieve summary
524information for an event(including the preferred szSource and szSourceEventID
525of the event).   011904 DK
526
527
528
529KNOWN DEFICIENCIES:
530*******************
531k2ew: Kinemetrics control software has been modified to configure location
532codes inside the K2 itself (in previously unused space). k2ew has not yet
533been modified to read these location codes from the K2 header. For the
534time-being, location codes must be set with the "LocationNames" command
535in the config file.  Lynn Dietz 2007/02/09
536
537ringtocoax:
538In Windows NT, the time resolution of sleep_ew() is about 16 msec (one clock
539tick).  On Solaris, the resolution is about 10 msec.  This is a problem for
540ringtocoax, since packet delays need to be set to a few milliseconds.
541
542statmgr: A space is needed between "tsec:" and the value.
543If it isn't there, things fail. Artifcat of the kom routines. (Alex)
544
545threads functions: The KillThread function on WindowsNT and Solaris
546terminate the thread without ensuring that no mutexes are held. If a thread
547holds a mutex when it dies, no other thread can get that mutex. PNL 1/12/2000
548
549carlsubtrig:
550The system time must be set to GMT and ew_nt.cmd must have
551TZ=GMT for carlsubtrig to work.  Comments in ew_nt.cmd done 5/25/00. Barbara
552       
553localmag:
554needs GMT set on the system
555
556ew2seisvole:
557on NT, exits with horrible crash when system is stopped.
558
559NUMBER OF RINGS LIMITED ON SOLARIS:
560Under Solaris 2.6 (and probably other versions as well), the maximum number
561of shared memory segments is six. This means that on an out-of-the-box machine
562you can only configure six rings. If you try to configure more than that, you
563will see a cryptic message from tport_create about too many open files.  The
564fix to this problem is to add the following lines to the /etc/system
565file, and then reboot the system.
566
567 set shmsys:shminfo_shmmax = 4294967295
568 set shmsys:shminfo_shmmin = 1
569 set shmsys:shminfo_shmmni = 100
570 set shmsys:shminfo_shmseg = 20
571 set semsys:seminfo_semmns = 200
572 set semsys:seminfo_semmni = 70
573
574This allows for 20 rings.
575
576     Lucky Vidmar (7/6/2000)
577
578startstop_solaris:
579Fixed bug in call to logit_init().
580The program was printing error messages:
581  Invalid arguments passed in.
582  Call to get_prog_name failed.
583  WARNING: Call logit_init before logit.
584
585startstop_solaris:
586There MAY be a problem with the signal that
587startstop sends to modules during the shutdown sequence. The shutdown
588sequence is started (after typing "quit" to startstop or running "pau")
589by startstop placing a terminate message on all transport rings. Modules
590should see this message and start their own shutdown. After a configurable
591delay, startstop checks to see that all modules have exitted. Any that are
592still running are sent a signal to terminate them. Currently that signal
593is SIG_TERM. But since wave_serverV has a handler for SIG_TERM, wave_serverV
594sees that as essentially the same as a terminate message. So if wave_serverV
595is having problems completing its shutdown, SIG_TERM won't do anything. The
596result is that startstop may give up and exit, leaving wave_serverV running.
597If that happens, the operator will have to terminate wave_serverV by doing
598"kill -9 <wave_serverV-pid>". That may leave shared memory and semaphores
599stranded in the kernel: run the command "ipcs -a" to see. If necessary,
600the stranded shared memory and semaphores may be cleaned up with the
601ipcrc command; must be run as root; see the man page.
602This problem only exists on Solaris/Unix, not on WindowsNT.
603PNL, 10/4/2000
604
605libsrc/utils/kom.c:  fix comment in k_open()
606
607The comment above k_open() says that only one file can
608be open at a time. Yet the Kbuf array has slots for MAXBUF (currently 4) open
609files. Does this work, or is the comment to be taken at it's word?
610PNL 10/15/00
611
612libsrc/utils/logit.c: logit_init() requires a module_id number, which it uses
613to construct the log file name. This is not helpful, since the module_id
614number is not meaningful to people. Worse, it requires that the config file be
615read and earthworm.d lookups be completed before logit calls can be made. Thus
616errors in the config file can only be reported to stderr or stdout instead of
617being saved in a file.  PNL 11/29/00
618
619libsrc/util/k2evt2ew.c: This library supports a maximum EVT data size
620of 800000 samples per channel per EVT file.  This value is hardcoded
621as MAXTRACELTH in include/k2evt2ew.h.  k2evt2ew() will return a warning
622if the EVT file exceeds this size, and process as much as the EVT file
623as the hardcoded limit allows.
624DK 2003/01/18
625
626import_ida:  Modified to build under WIN32(#ifdef'd a couple of includes
627and modified the NT makefiles.)  (saved under tag HYDRA_V1-20)
628Modified for SCNL and Tracebuf2.
629DK 2005/04/22
630
631
632TRACEBUF messages.
633The definition of `endtime' of the TRACEBUF message is not documented.
634Some programmers are taking it as the "expected start time of the next
635TRACEBUF packet (if the sample interval is uniform.)" The more accepted
636practice is that `endtime' is the time of the last sample of the current
637TRACEBUF packet; that is, one sample interval less than the expected
638start time of the next TRACEBUF messsage. Using this last definition, if a
639TRACEBUF packet has exactly one sample, then its starttime and endtime are
640the identical. Clearly this distinction needs to be documented. The file
641waveform_format (in the /home/earthworm/DOC directory) gives no specifics
642about start or end times.  PNL 1/24/01
643
Note: See TracBrowser for help on using the repository browser.