This is a view of processor activity, analogous to the ps module but with data aggregated by user name, for Linux and FreeBSD based machines.
For example, a single line of data will show the CPU usage, memory usage and possibly number of files summed for all the processes belonging to the user jdoe.
Note that the memory usage and real size are approximated when there are several instances of the same program running, as some of the memory used is shared among the instances, preventing accurate calculations in determining which part of the total memory can be attributed to which user. For example, it is possible that the addition of all the cells in the memory column gives more than 100 percent.
Note: for FreeBSD, the Linux compatibiliy proc filesystem must be available in /compat/linux/proc (see --proc option below).
Module options:
- -C (only available for ssh on UNIX client)
Whether data compression is used on all data between client and server (useful on slow connections, see ssh manual for detailed information).
- --files
whether the files column is displayed (off by default). This gives the total number of open files (actual files, sockets, ...) per user. Note that depending on the user who started moodss, not all file counts are displayed (usually only for that user's processes). Run moodss as root if you want to see the file counts for all processes.
- -i file (only available for ssh on UNIX client)
Selects a file from which the identity (private key) for authentication is read (useful if an authentication agent is not running). It must not be protected by a passphrase.
- -p port (only available for ssh on UNIX client)
Port to connect to on the remote host.
- --proc directory
Data directory, also known as proc filesystem, /proc by default (for Linux machines support). For example, use /compat/linux/proc for FreeBSD machines.
Note: the data contained in that directory must be in a format identical to the reference Linux implementation.
- -r (--remote) [[rsh|ssh]://][user@]host
remote monitoring using user as logname on remote host host (rsh or ssh facilities must be properly setup). If user is not specified, current user is used as logname on remote host. The protocol is either ssh or rsh (used by default). The module title is set to psbyuser(host).
- -u (--users) user[,user,...]
a comma separated list of users (by name or ID). Only processes that belong to a user ID or name included in the specified list are taken into account in the displayed data.
Notes on remote monitoring:
- Using ssh is strongly recommended, as rsh, while being much less secure is also less efficient, as it requires creating a new session for each poll.
- On a Windows client, you must use the putty software package (see install.txt), which does not support rsh in non interactive sessions. Consequently, the -r (--remote) ssh://session syntax is required to remove any confusion (where session has been added to the running pageant application).
Examples:
$ moodss psbyuser -r jdoe@foo.bar.com
$ moodss psbyuser -r ssh://jdoe@foo.bar.com
$ moodss psbyuser --remote foo.bar.com --all
$ moodss psbyuser -u root,jdoe --files
$ moodss psbyuser --users 0 -r foo.bar.com