| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| module:logonlist [2020/04/04 20:00] – [Logon List] Added screenshot digital man | module:logonlist [2026/02/18 03:47] (current) – [Configure] Document last_few_days digital man |
|---|
| |
| ===== Install ===== | ===== Install ===== |
| To install the Logon List module, execute from a command-line: | This module (''logonlist'') should be the default value of SCFG->System->Loadable Modules->List Logons. |
| jsexec logonlist install | |
| |
| | If a sysop needs to install this module, it can be installed with the command-line ''[[util:jsexec]] logonlist install''. |
| ===== Invoke ===== | ===== Invoke ===== |
| | The default behavior of the Logon List module (when no command-line options are provided) is to display all user logons that have been logged so far today, in the order in which they were logged (normally, by the [[module:logon|Logon Module]]). |
| | |
| The Logon List module supports the following command-line options: | The Logon List module supports the following command-line options: |
| |
| ^ Option ^ Description ^ | ^ Option ^ Description ^ |
| | ''-l'' | Display only the "last few" logons (callers), the default is to display the entire list | | | ''-l //[count]//'' | Display only the "last few" logons (callers), possibly over multiple days | |
| | ''-y'' | Display logons from yesterday rather than today | | | ''-y'' | Display all logons that occurred yesterday | |
| | | ''//days//'' | Display all logons from the specified number of days ago | |
| | ''-m'' | Maintain the Logon List files, must be executed daily, e.g. via "System Daily Event" or Timed Event | | | ''-m'' | Maintain the Logon List files, must be executed daily, e.g. via "System Daily Event" or Timed Event | |
| |
| ===== Configure ===== | ===== Configure ===== |
| |
| The Logon List module supports the following options in the ''[logonlist]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file: | The Logon List module supports the following options in the ''[logonlist]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file or the //root// section of the ''[[dir:ctrl]]/modopts/logonlist.ini'' file: |
| |
| ^ Option ^ Default ^ Description ^ | ^ Option ^ Default ^ Description ^ |
| | | ''last_few_days'' | 0 | The maximum number of //previous days// to pull last few callers from | |
| | ''last_few_callers'' | 4 | Number of logons to display when only displaying the "last few" (not the entire list) | | | ''last_few_callers'' | 4 | Number of logons to display when only displaying the "last few" (not the entire list) | |
| | ''last_few_callers_msg'' | (see source) | The string to announce the "Last few callers" list | | | ''last_few_callers_msg'' | (see source) | The string to announce the "Last few callers" list | |
| | ''backup_level'' | 10 | Number of previous logon list files to retain | | | ''backup_level'' | 10 | Number of previous logon list files to retain | |
| | ''today'' | "Today" | The word displayed to represent the current day | | | ''today'' | "Today" | The word displayed to represent the current day | |
| | ''yesterday'' | "Yesterday | The word to displayed to represent the day before the current day | | | ''yesterday'' | "Yesterday | The word displayed to represent the day before the current day | |
| | | ''time_fmt'' | "%H:%M" | The [[https://cplusplus.com/reference/ctime/strftime/|strftime]] format of the logon date/time to be displayed | |
| ===== See Also ===== | ===== See Also ===== |
| * [[:module:|module index]] | * [[:module:|module index]] |
