The program htmlusers
The following description of htmlusers is mostly for systems
administrators. This command was never intended for regular users.
htmlusers - list local users with hypertext information
Htmlusers builds a list of those local users that have a
directory named .html in their home directory. The list is
sorted in three different ways and the result is output to three files
written in hypertext format using the HTML language.
Normally this is run hourly by cron(8).
The outfile argument is used as a prefix value for the names
of the three files that are written. The appended suffixes are
-byuser.html, -byreal.html and -bytime.html.
Most of the behaviour of htmlusers is hardcoded, but through
the use of a configfile you may alter some of it. In the
config file you can have blank lines, comments (starting with a #
character) and commands. The following commands can be used.
- The byuser list is sorted by username and has two
fields per line - the name and the file. The fields consists of two
parts - the username and the real name for the name
field - the modify time and the filename for the
- The byreal list is sorted by the users real name
and has two fields per line - the name and the file. The fields
consists of two parts - the real name and the
username for the name field - the modify time and
the filename for the file field. Note that this list is
different from the byuser list only in the order of the
user/real name parts of the name field. Also note that this list is
sorted as Swedish text and not by ASCII value.
- The bytime list is sorted by the modify time of
the last modified file in the users .html directory and has
two lines per user - the name and the file. The lines consists of two
fields - the username and the real name for the name
line - the modify time and the filename for the file
line. This list is numbered, the others are not.
The simplest case:
- exclude filename ...
- Skip all files named filename when searching for each
users last modified file. Usually you wish to exclude files that are
updated automatically, thus deemed uninteresting.
- name user real name
- Set the real name for the user user to be real
name. It is sometimes useful to override the real name entry
from the passwd file, e.g. if a user has got a strange or
invalid name in the passwd file or when the real name contains special
characters that are not suitable for putting in the passwd file.
would create three files named
The most complex case:
htmlusers users config.run
would do almost exactly the same thing as the previous example, except
that it might produce slightly different output depending on the
contents of the file config.run.
# A sample run time config file for htmlusers.
name henrik Henrik A. Cañadas
#name birger Birger Edström
name birger Birger Edstrðm
Sometimes a lockfile may be left around. If that happens you'll need
to remove it manually.
The config command exclude does not expand wildcard characters
like the shell, i.e. *, ? and [ does not
work as expected.
Htmlusers first appeared at
in 1993. The first version was a combination of C programs and shell
scripts. The latest version of htmlusers is a single C program
that collects, processes and writes its data all by itself.
Mikael Adolfsson (firstname.lastname@example.org)