phoc - Man Page

A Wayland compositor for mobile devices

Synopsis

phoc [OPTIONS...]

Description

phoc is a Wayland compositor for mobile devices using the wlroots library. It's often used with the phosh mobile shell but works perfectly fine on its own.

Options

-h,  --help

Print help and exit

-C,  --config FILE

Path to the configuration file. (default: phoc.ini).

-E,  --exec EXECUTABLE

Executable (session) that will be run at startup

-S,  --shell

Whether to expect a shell to attach

-X,  --xwayland

Whether to start XWayland

--version

Show version information

Configuration

Configuration is read from phoc.ini, hwdb and gsettings. For details on output configuration see phoc.ini(5), for details on wakeup key configuration via hwdb see gmobile.udev(5), for details on the gsettings handled by phoc see phoc.gsettings(5).

Environment Variables

phoc honors the following environment variables:

Udev Properties

Apart from the udev properties for wakeup keys documented in gmobile.udev(5) phoc uses ID_INPUT_KEYBOARD to identify hardware keyboards. You can use hwdb to override these.

Dbus Interface

phoc allows to enable and disable certain debug flags at runtime via DBus. To see a list of available flags use:

busctl --user introspect mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl

To toggle individual values:

busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl TouchPoints b true
busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl DamageTracking b true
busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl LogDomains as 1 all
busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl LogDomains as 2 phoc-seat phoc-layer-surface

Note that the flags are not considered stable API so can change between releases.

See Also

phoc.ini(5) phoc.gsettings(5) gmobile.udev(5) phosh(1) busctl

Referenced By

gmobile.udev(5), phoc.gsettings(5), phoc.ini(5).