Provide Photon system information
phin [-AhLMqW] [-f chars] [-n name] [-P name]
[-p pid] [-R rid] [-r rid] [-T type] [command]
- -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
|
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
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
![[Previous]](../prev.gif)
![[Contents]](../contents.gif)
![[Index]](../keyword_index.gif)
![[Next]](../next.gif)