---

phin

Provide Photon system information

Syntax:

phin [-AhLMqW] [-f chars] [-n name] [-P name]
     [-p pid] [-R rid] [-r rid] [-T type] [command]

Runs on:

Neutrino

Options:

-A

Show all regions.

-f chars

Instead of a command, use the specified string of format characters. Valid characters are:

• + -- indent by family generation
• A -- absolute area
• a -- area
• B -- event buffer size
• b -- blocked state
• c -- region cursor
• d -- node
• e [isTRWcdDEBm#k] -- event flags^*
• F -- family RIDs
• f [BFAIKPGMW] -- region flags^*
• G [BTPHD] -- channel flags^*
• g [VABHCD] -- process flags^*
• h -- handle
• I -- input group
• i -- priority
• k -- blocked state and pid
• M -- proxy
• N -- fullpath
• n -- name
• O -- absolute origin
• o -- relative origin
• P -- parent RID
• p -- Process ID (PID)
• Q -- max number of enqueued events
• q -- number of enqueued events
• R [Mncmtrb] -- window render flags^*
• r -- Region ID (RID)
• S [MDpIihfARF] -- window state flags^*
• T -- window title
• w [FBXIMRs<>fTC] -- window flags^*
• z -- region size

---

* See the Description section for details on these options.

---

-h

Suppress header information.

-L

Be literal: display flags fields in hex.

-M

Display for manager type regions only.

-n name

The name of the Photon Manager to communicate with. If the name starts with a digit, the utility treats it as a node number and communicates with /dev/photon on that node. If the name starts with a slash, the utility treats it as a full path. Otherwise, the utility looks for it in your /dev directory. The default is /dev/photon.

-P name

Show information only for the process with this name.

-p pid

Show information only for the process with this PID.

-q

Suppress all output; the exit value is the number of regions that would have been listed.

-R rid

Start with the region that has this region identifier (RID) and show information about its children and the siblings behind.

-r rid

Show information only for the region with this RID.

-T type

Display information only about this type of region:

• G -- Graphics driver type regions
• I -- Input group type regions
• K -- Keyboard driver type regions
• M -- Window manager type regions
• P -- Pointer driver type regions (mouse or touchscreen)
• W -- Application windows type regions

-W

Show window type regions only.

command

A command that lets you view specific groups of information and provides a compact way to specify commonly used -f combinations. Only the first two letters of a command are required:

Command	Description	Equivalent
all	All the commonly used flags	pnbrPFfehOzwST
areas	Region absolute areas and origins	prPOAn
channel	Channel information	dprPgGkMqQBn
cproc	Channel and process	dprPgkqQnib
default	Simple process and region flags	prPfenb
family	Region parent, child, and brother info	prPFfen
rareas	Region relative areas and origins	prPoan
regions	Specific info about regions	prPfeOz
sculpted	Region and process info, indented by depth	+prPibnT
window	Specific info about windows	rnwST
wprocess	Process info about windows	rpiSnT

Description:

The phin utility displays information about the state of the Photon window system.

Here's what the options of the region flags, event flags, window flags, window render, window state, process flags, and channel flags indicate.

Region flags:

-f [BFAIKPGMW]

• B --Force boundary
• F --Force front
• A --Audio
• I --Input group
• K --Keyboard
• P --Pointer
• G --Graphics
• M --Window Manager
• W --Window Region

Event flags:

-e [isTRWcdDEBm#k]

• i --Info events
• s --System events (s is low bandwidth, S is high bandwidth, and A is all)
• T --Timer events
• R --Raw events
• W --Window-Manager events
• c --Covered events
• d --Drag events
• D --Draw events
• E --Expose events
• B --Boundary events
• m --Motion flags: (m is EV_PTR_MOTION; M is EV_PTR_MOTION_BUTTON; A is both m and M)
• # --Button flags: (1 is EV_BUT_PRESS; 2 is EV_BUT_RELEASE; 4 is EV_BUT_REPEAT). Note that buttons accumulate (e.g. EV_BUT_PRESS+EV_BUT_RELEASE=3).
• k --Sensitive/opaque to key events

Window flags:

-w [FBXIMRS<>fTC]

• F --Foreground
• B --Backdrop
• X --Maximize
• I --Iconify
• M --Move
• R --Resize
• s --Console switch
• < --To back
• > --To front
• f --Focus
• T --Terminate
• C --Close

Window render:

-R [Mncmtrb]

• M --Maximized
• n --Minimized
• c --Close
• m --Menu
• t --Title
• r --Resize
• b --Border

Window state:

-S [MDpIihfARF]

• M --Is maximized
• D --Is a backdrop
• p --Is PDM
• I --Is an icon
• i --Is iconified
• h --Is hidden
• f --Force front
• A --Accepts Alt keys
• R --Is Remote
• F --Is Focused

Process flags:

-g [VABHCD]

• V --Virtual
• A --Armed
• B --Blocked
• H --Held
• C --Catch up
• D --Dynamic Buffer

Channel flags:

-G [BTPHD]

• B --Block overflow
• T --Term overflow
• P --No proxy
• H --No hold
• D --Dynamic Buffer

Examples:

Display default information:

phin

Display information about windows on node my_node:

phin -n my_node window

Display information about regions on the device /net/my_node/dev/photon:

phin -n /net/my_node/dev/photon regions

Display parent, child, and brother information about regions on the device /dev/photon:

phin -n photon family

---