home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Tools / workspace / MOTD.README < prev    next >
Encoding:
Text File  |  1995-02-24  |  6.3 KB  |  166 lines
  1. CHANGES FOR 3.0
  2.  
  3. The MOTD application no longer updates the /usr/adm/wtmp and /usr/adm/lastlog
  4. files.  This deficiency in Workspace has been corrected in 3.0.  Thus, there
  5. is no longer a LogoutHook component.  You'll want to:
  6.  
  7.     dremove loginwindow LogoutHook
  8.  
  9. if you were previously using the '/usr/local/bin/LogoutHook' component.
  10. You should also do:
  11.  
  12.     dwrite loginwindow LoginHook /LocalApps/MOTD.app/MOTD
  13.     
  14. to change the LoginHook from 'LocalApps/MOTD' to '/LocalApps/MOTD.app/MOTD'.
  15.  
  16. MOTD now handles '*.rtfd' files but it no longer assumes that if the first
  17. character of a file is {, then it is in RTF format.  It now only looks at
  18. file name extensions (*.rtf & *.rtfd) to determine if a file contains RTF.  
  19.  
  20. MOTD no longer uses the files mail.snd and newmail.snd on the
  21. /LocalLibrary/Sounds directory (these *.snd files contained the "You have mail"
  22. and "You have new mail" voice alerts).  Instead, it contains localizable
  23. sound files in the MOTD.app application bundle itself.
  24.  
  25. The system defaults have been moved from the MOTD.h to the file
  26. Defaults.strings in the MOTD.app application bundle.
  27.  
  28.  
  29. DESCRIPTION
  30.  
  31. The MOTD application (designed to run as a LoginHook under loginwindow or
  32. be launched) displays the contents of the file /etc/motd (or any file you
  33. choose) in a window when a user logs on.  By default, the application checks
  34. the modification date of the file against the user's last login time (as
  35. recorded in /usr/adm/wtmp) and does nothing if the file hasn't changed.
  36.  
  37. The MOTD window has three buttons, one to hold the window on the screen
  38. (it goes away automatically in 25 seconds--the hold button displays the
  39. count down), another to quit (and proceed with the login) and a third to
  40. cancel the login (only enabled if MOTD is run as a LoginHook).  MOTD also
  41. implements a Mail Alert panel which appears if there is unread mail.  The
  42. panel automatically goes away (in a couple of seconds) if there isn't a
  43. new /etc/motd message. 
  44.  
  45. To get an idea of what MOTD does (without installing it), as root do:
  46.  
  47.         #touch /etc/motd
  48.         #MOTD
  49.  
  50. When used as a LoginHook, the window appears over a blank screen just as
  51. the user logs in.  MOTD supports RTF.
  52.  
  53.  
  54. INSTALLATION
  55.  
  56. To install MOTD as a LoginHook, put it on /LocalApps, and as root do:
  57.  
  58.         dwrite loginwindow LoginHook /LocalApps/MOTD.app/MOTD
  59.  
  60. alternatively, the file /etc/ttys can be modified to include the -LoginHook
  61. arguments to loginwindow.
  62.  
  63. You may want to consider commenting out the following lines in
  64. /usr/adm/monthly that trim the wtmp and lastlog files or else users may see
  65. messages they've read over again and the loging information won't be correct:
  66.  
  67.         # Trim the lastlog
  68.         # cp -p /usr/adm/lastlog /usr/adm/lastlog.old
  69.         # cat /dev/null > /usr/adm/lastlog
  70.  
  71.         # Trim wtmp
  72.         # cp -p /usr/adm/wtmp /usr/adm/wtmp.old
  73.         # cat /dev/null > /usr/adm/wtmp
  74.  
  75. You may want to come up with some less frequent  scheme for triming the wtmp
  76. file.  A program that can do this, trimwtmp.c, is included and can be added
  77. to the /usr/adm/monthly cleanup.   See the trimwtmp.c file for details.
  78. Finally, restart the window server (login as EXIT or reboot) for this to
  79. take effect.  Update /etc/motd as appropriate.
  80.  
  81. If you don't want to make MOTD a requirement for users, then don't make it
  82. a LoginHook but instead have interested users add it to their dock and set
  83. it launch at startup using the 'Preferences...' panel of Workspace.
  84.  
  85. DEFAULTS
  86.  
  87. MOTD has the following defaults that can be changed (if used as a LoginHook,
  88. they have to be changed in root's defaults database):
  89.  
  90.     File -- The file to display, defaults to /etc/motd.
  91.     
  92.     Wait -- The amount of time to display File, defaults to 25 seconds.
  93.         
  94.     MailWait -- The amount of time to display mail alert, defaults to 2
  95.                 seconds.
  96.         
  97.     Hold -- Whether or not (Yes or No) to come up held, No by default.  If
  98.             Yes then the Hold button won't appear.
  99.  
  100.     OnlyOnce -- Whether or not (Yes or No) to check file date, Yes by default.
  101.                 If No, displays file on every login.
  102.  
  103. The defaults can be changed via root's defaults database or by editing their
  104. values in the Defaults.strings file in the MOTD.app application bundle.
  105.  
  106. MOTD also uses the SystemAlert default of the System entry in the defaults
  107. database to control voice messages on the mail alerts.  This value can be
  108. set (by root if MOTD is a LoginHook) via the 'Use Voice Alerts' checkbox in
  109. the Preferences application. You may need to force an entry for SystemAlert
  110. by cycling the 'Use Voice Alerts' checkbox (turning off and on the check
  111. mark) as root's defaults database may not contain an entry for SystemAlert
  112. even though the checkbox is selected.
  113.  
  114.  
  115. FILE FORMAT
  116.  
  117. The File is assumed to be any plain text format acceptable to a ScrollView.
  118. MOTD also recognizes the 'rtf' and 'rtfd' file extensions as RTF (rich text
  119. format) files and displays them as such.  If you use RTF files with MOTD, it
  120. is probably best to create separate files, motd and motd.rtf, and change
  121. the File default above to use the motd.rtf (or motd.rtfd) file (dwrite the
  122. new File default as root if MOTD is a LoginHook):
  123.  
  124.     dwrite MOTD File /etc/motd.rtf
  125.  
  126. This prevents network logins being presented with the RTF structured text.
  127.  
  128.  
  129. DIAGNOSTICS
  130.  
  131. MOTD is designed to run as a LoginHook for the loginwindow program and thus
  132. always tries to return success (0), even on error, so that the user can
  133. still log in if the program runs into trouble.  The 'Cancel Login' button
  134. causes the program to exit with failure (1) and abort the login.
  135.  
  136.  
  137. BUGS
  138.  
  139. MOTD determines that a file is in RTF format based on its extension and
  140. doesn't look at content.
  141.  
  142. An affirmative database value for Hold and OnlyOnce can be 'Yes' , YES'  or
  143. 'yes'  but not 'true' .  Anything not starting with Y/y is considered 'No'.
  144.  
  145. The console device that MOTD enters into the wtmp file is hardcoded in
  146. MOTD_main.m since basename(ttyname(0)) didn't work in the context of a
  147. LoginHook.
  148.  
  149. The timeout should probably be a function of the number of lines of text
  150. in the file being displayed.
  151.  
  152.  
  153. AUTHORS
  154.  
  155. Christopher Lane (lane@sumex-aim.stanford.edu)
  156. Symbolic Systems Resources Group
  157. Knowledge Systems Laboratory
  158. Stanford University
  159.  
  160. Izumi Ohzawa (izumi@violet.berkeley.edu)
  161. Group in Neurobiology/School of Optometry
  162. University of California, Berkeley
  163.  
  164. Steve Hayman (sahayman@cs.indiana.edu)
  165. Computer Science Department Workstation Manager
  166.