`sin`

Display system information

Syntax:

sin [options] [command]...

Runs on:

All supported platforms.

Options:

-l seconds: ("el") Loop with a pause of seconds between iterations.
-n nodename: Get information from the node with the given nodename.
-P pattern: Show information about the process with the given name.
-p pid: Show information about the process with the given ID.
-r: Select processes with at least one ready thread.
-S type: Sort by type, which must be one of code, data, name, pid, sid, or time.
-s sid: Select processes by session ID.
-u uid: Select processes belonging to the given user ID.

The command variables include:

args (or ar)

Show the arguments of the displayed process.

env (or en)

List the environment variables used by the displayed process.

fds (or fd)

Show information about the file descriptors used by the displayed process. From the left, the columns show:

file descriptor (items suffixed with an s indicate that the connection is a side channel created with the _NTO_SIDE_CHANNEL flag)
process ID of the server
read/write mode
memory offset/size
the path associated with the file descriptor

info (or in)

Display information about the system, such as the type of processor and amount of free memory.

memory (or me)

Show the memory used by the displayed process.

From the left, the columns show:

name of program or device
virtual address
virtual address offset
size of code memory
code memory mapping flags
size of data memory
data memory mapping flags.

The memory mapping flags are as follows:

S -- shared memory
P -- private memory
A -- anonymous memory
R -- read permission
W -- write permission
X -- execute permission
N -- cache not allowed

For more information, see mmap() in the Neutrino Library Reference.

registers (or re)

Show information about the register sets that the displayed process is using.

Currently, this feature is available only for x86.

From the left, the columns show:

TID -- thread ID
EAX -- accumulation register
EBX -- accumulation register
ECX -- accumulation register
EDX -- accumulation register
ESI -- general purpose register
EDI -- general purpose register
EBP -- stack frame pointer
ESP -- stack pointer

signals (or si)

Show the signal state of the displayed process. From the left, the columns show:

Tid -- thread ID
Ignored/Blocked (64-49.48-33) -- mask for signals 33-64
Ignored/Blocked (32-17.16-1) -- mask for signals 1-32
Pending (64-49.48-33) -- signals 33-64 waiting to be unmasked
Pending (32-17.16-1) -- signals 1-32 waiting to be unmasked

threads (or th)

Show information about the threads of the displayed process. From the left, the columns show:

Tid -- Thread ID
Priority -- scheduling priority number and scheduling algorithm (see below)
State -- current state of the thread (see below for possible states)
Blocked -- the PID that this process is blocked on
IP -- the EIP register set used by the displayed process
CPU -- CPU occupancy time in milliseconds

The letter following the scheduling priority number stands for the scheduling algorithm used, as follows:

f -- FIFO scheduling
r -- round-robin scheduling
o -- other (currently, same as round-robin scheduling)
s -- sporadic scheduling

For more information on these scheduling algorithms, see "Thread scheduling" in the System Architecture guide.

Possible thread states:

State:	Meaning:
CONDVAR	blocked on a condition variable
DEAD	terminated, waiting for a join by another thread
INTERRUPT	blocked, waiting for interrupt
JOIN	blocked, waiting to join another thread
MUTEX	blocked on a mutual exclusion lock
NANOSLEEP	sleeping for a short time
READY	waiting while processor executes another thread
RECEIVE	blocked on a message receive
REPLY	blocked on a message reply
RUNNING	being executed
SEM	waiting for a semaphore to be posted
SEND	blocked on a message send
SIGSUSPEND	blocked waiting for a signal
SIGWAITINFO	blocked waiting for a signal
STACK	waiting for virtual address space allocation
STOPPED	blocked, waiting for a SIGCONT signal
WAITCTX	waiting for a non integer (e.g. floating point) context
WAITPAGE	waiting for physical memory allocation
WAITTHREAD	waiting for child thread creation

users (or us)

Show information about the users of the displayed process. From the left, the columns show:

UID -- real user ID
EUID -- effective user ID
SUID -- saved user ID
GID -- real group ID
EGID -- effective group ID
SGID -- saved group ID

Description:

The sin command displays textual system information about the processes running on a QNX Neutrino system (for a graphical version of this command, see psin).

The command variables let you specify the information you are interested in. If you don't specify a command, sin displays the following information for each selected process:

process ID
size of code memory
size of data memory
amount of stack currently mapped
maximum amount of stack allowed
total CPU occupancy time in milliseconds.

By default, sin displays the information once and then exits. If you specify the -l, sin loops forever, displaying statistics after the delay specified by the seconds option variable.

Examples:

Display information about processes belonging to the user techpubs:

$ sin -u techpubs
procnto                                 1     0     0     0     0 268759990
devc-con                                2   36K   68K  128M  128M       614
pci-bios                                3   28K   60K    4K  516K        16
tinit                                   4    8K   44K    4K  516K         4
devb-eide                               5   24K 12352K   36K  612K    128152
slogger                              4103    8K   80K   20K  536K         5
pipe                                 8200   12K  480K   24K 1045K      8181
fs-pkg                             565254   96K  468K   80K 1177K     10952
devc-pty                           638987   24K  140K    4K  640K       712
mqueue                             638988    8K   64K    4K  640K         5
devc-ser8250                       655370   24K   60K    4K  640K         5
devc-par                           655375   24K  100K    8K  648K       323
io-net                             655377   40K  488K   40K 1213K     16862
spooler                            655379   12K   52K   12K  524K     11755
dhcp.client                        663565   36K  124K   16K  648K        15
dumper                             696329   12K   52K   24K  644K        27
Photon                             786450   64K  100K   12K  524K     11534
phfontFA                           843798  284K 1473K   12K  516K     14287
fontsleuth                         851988   16K  136K   12K  652K        16
io-graphics                        880663  144K  264K    8K  385M     11048
devi-hirun                         901147   52K  244K   20K  912K      1726

Display information about the process with a given ID:

$ sin -p 4280354
helpviewer                        4280354  592K  604K   20K  516K        69

Display the command-line arguments for the process with a given ID:

$ sin -p 2330650 args
io-graphics                       2330650  188K 1805K    8K  516K     81362
   io-graphics -g1024x768x16 -dldevg-banshee.so -I0 -d0x121a,0x5

sin