Update usage for verbosity.
[userinfo.git] / NEWS
blobf00809f70b2e522cc2691eb2709d4ff6fc61e06c
1 userinfo 2.1 released
2     This release includes some major fixes and code cleanups. Module writers
3     should have another look at doc/README.modules as all of the function
4     names have changed (ui_module_exec() not passwd_exec()). Details follow:
6     The command line options -x and -X behave like -O in that they take a
7     module name to load. No need to specify both.
9     Verbosity (-v) is reset for each module unless specified twice.
11     The strings UNKNOWN, NONE, ON and OFF are more hardcoded and are not
12     configurable in config.h. The ui_module_exec() function has changed to
13     drop these strings and module writers should look at the 'Output Key' from
14     'ui -h' as a guideline for static strings. It's kinda pointless but there
15     are less arguments to this function to worry about.
17     A modules help and dup warning is only shown once.
19     Fixed a memory leak in the login.so module.
21     Fixed module chaining of more than two modules.
23     Bugfix for modules which take no options.
25     Bugfix for the -d option when used with other modules.
28 userinfo 2.0 released December 05, 2004
29     It's been awhile since the last release, but hopefully worth the wait. The
30     program has been split up into modules which will need to be loaded either
31     from the command-line or from a configuration file. See doc/uirc for an
32     example configuration file and doc/README.modules for how to write your
33     own modules. Here's some details about the changes:
35     Added option -m to specify a deliminator for multi-value fields. The old
36     hardcoded character, and new default, was/is a comma.
38     Added option -O, -d and -c to load modules. Read the manual page or look
39     at doc/uirc for configuration file syntax.
41     Added option -d to load the default modules (passwd.so, mail.so, and
42     login.so). By default, no modules are loaded. This option may be used
43     anywhere in the module list.
45     Added option -x to chain the output of a loaded module to the input of the
46     next loaded module. This will only work if the next loaded module is
47     chainable.
49     Added option -X to prevent the chained module from outputting it's info.
50     This will just pass the strings which would be outputted to the next
51     module (like -x).
53     Changed the main executable options a bit:
54         Changed option -F to -l (symbolic links)
55         Changed option -j to -t (time format)
56         Changed option -d to -F (field separator)
58     The default time format has changed to "%s" (seconds since epoch). The old
59     format contained a ":" which is the default field separator. Use -t to
60     change it to whatever you want. If your running Solaris please read
61     KnownBugs.
63     Changed the options for the modules a bit. To see the options for the
64     modules, load the module with -O, or -c if using a configuration
65     file, or both, when using the -h help switch.
67     The login module now supports multiple logins of the same username. For
68     example, if a user is logged in more than once and the -y module option is
69     specified the output might be: tty2,tty3.
71     Added an example module and shell script to contrib/ in the archive.
73     When a user has logged in via console and the hostname option in the login
74     module is requested, either from the lastlog or from utmp, display the
75     "none" string rather than the "unknown" string.
77     Port to NetBSD. May compile on OpenBSD too, but it hasn't been tested.
79     Removed the Darwin port. It's just not worth the hassle.
81     Automake has been updated. This means DESTDIR support is included in the
82     Makefile.
84     Fixed ouput of empty password fields from getpwnam().
86     Don't try an convert passwd.so options -c and -e to a time stamp, just
87     dump the passwd structure strings. The exception is if the user is not
88     root, then the unknown string is used. Different OS's use different
89     methods when displaying these values. See getspnam(3) or getpwent(3).
91     We now use getutxent() on systems that support and utilize utmpx. Login
92     process id's are gotten from this utmpx structure rather than KVM or the
93     /proc filesystem. Much more efficient and less error-prone.
95     When requesting the mail folder size and the size is zero, display zero
96     and not the "none" string.