motd.tail(5) [linux man page]

MOTD.TAIL(5)						   Debian Administrator's Manual					      MOTD.TAIL(5)

NAME

       motd.tail - Template for building the system message of the day

DESCRIPTION

       On Debian systems, the system message of the day is rebuilt at each startup, in order to display an accurate information. /etc/motd.tail is
       the file to edit permanent changes to the message of the day.

OVERVIEW

       The initiation script /etc/init.d/bootmisc.sh prepends a line containing information about the system  to  /etc/motd.tail  and  stores  the
       resulting  file in /var/run/motd. /etc/motd is a symbolic link to /var/run/motd.  This is done to prevent changes to /etc as the system can
       not assume /etc to be writable.

       Changes to /etc/motd effectively end up in a file under /var/run which will be regenerated upon reboot.

       A symbolic link to a different file, such as /etc/motd.static disables this behaviour.

FILES

       /etc/init.d/bootmisc.sh
	      The initiation script which builds /var/run/motd

       /etc/motd
	      Symbolic link to the system message of the day at /var/run/motd

       /etc/motd.tail
	      Template for building the system message of the day

       /var/run/motd
	      System message of the day file rebuilt at each computer start

SEE ALSO

       login(1), issue(5), motd(5).

Debian								    2007-04-28							      MOTD.TAIL(5)

update-motd(5)							File Formats Manual						    update-motd(5)

NAME

       update-motd - dynamic MOTD generation

SYNOPSIS

       /etc/update-motd.d/*

DESCRIPTION

       UNIX/Linux  system  adminstrators  often  communicate  important  information  to  console and remote users by maintaining text in the file
       /etc/motd, which is displayed by the pam_motd(8) module on interactive shell logins.

       Traditionally, this file is static text, typically installed by the distribution and only updated on release upgrades,  or  overwritten	by
       the local administrator with pertinent information.

       Ubuntu introduced the update-motd framework, by which the motd(5) is dynamically assembled from a collection of scripts at login.

       Executable scripts in /etc/update-motd.d/* are executed by pam_motd(8) as the root user at each login, and this information is concatenated
       in /var/run/motd.  The order of script execution is determined by the run-parts(8) --lsbsysinit option (basically alphabetical order,  with
       a few caveats).

       On Ubuntu systems, /etc/motd is typically a symbolic link to /var/run/motd.

BEST PRACTICES

       MOTD fragments must be scripts in /etc/update-motd.d, must be executable, and must emit information on standard out.

       Scripts	should be named named NN-xxxxxx where NN is a two digit number indicating their position in the MOTD, and xxxxxx is an appropriate
       name for the script.

       Scripts must not have filename extensions, per run-parts(8) --lsbsysinit instructions.

       Packages should add scripts directly into /etc/update-motd.d, rather than symlinks to other scripts, such that administrators can modify or
       remove  these  scripts  and  upgrades  will not wipe the local changes.	Consider using a simple shell script that simply calls exec on the
       external utility.

       Long running operations (such as network calls) or resource intensive scripts should cache output, and only update that	output	if  it	is
       deemed expired.	For instance:

	 /etc/update-motd.d/50-news
	 #!/bin/sh
	 out=/var/run/foo
	 script="w3m -dump http://news.google.com/"
	 if [ -f "$out" ]; then
	   # Output exists, print it
	   echo
	   cat "$out"
	   # See if it's expired, and background update
	   lastrun=$(stat -c %Y "$out") || lastrun=0
	   expiration=$(expr $lastrun + 86400)
	   if [ $(date +%s) -ge $expiration ]; then
	     $script > "$out" &
	   fi
	 else
	   # No cache at all, so update in the background
	   $script > "$out" &
	 fi

       Scripts should emit a blank line before output, and end with a newline character.  For instance:

	 /etc/update-motd/05-lsb-release
	 #!/bin/sh
	 echo
	 lsb-release -a

FILES

       /etc/motd, /var/run/motd, /etc/update-motd.d

SEE ALSO

       motd(5), pam_motd(8), run-parts(8)

AUTHOR

       This  manpage  and the update-motd framework was written by Dustin Kirkland <kirkland@canonical.com> for Ubuntu systems (but may be used by
       others).  Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License,  Version
       3 published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

update-motd							   13 April 2010						    update-motd(5)