Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PHOC()									  PHOC()

NAME
     phoc - 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

     --socket
	    Wayland socket to listen on for client connections

     -S, --shell
	    Whether to expect a shell to attach

     -X, --xwayland
	    Whether to start XWayland

     --no-xwayland
	    Whether to disable XWayland

     --version
	    Show version information

CONFIGURATION
     Configuration   is   read	  from	  phoc.ini,    hwdb,	gsettings    and
     $XDG_STATE_HOME/outputs.gvdb.   For  details  on  output  configuration see
     phoc.ini(5), for details on wakeup key  configuration  via  hwdb  see  gmo-
     bile.udev(5),  for  details on the gsettings handled by phoc see phoc.gset-
     tings(5). For details on output states see phoc-outputs-states.

ENVIRONMENT VARIABLES
     phoc honors the following environment variables:

     * WLR_BACKENDS: The backends the  wlroots	library  should  use  when  phoc
       launches. See
	<https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/mas-
       ter/docs/env_vars.md>

     * WLR_RENDERER:  The  renderer  the  wlroots  library  should use when phoc
       launches. See
	<https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/mas-
       ter/docs/env_vars.md>

     * G_MESSAGES_DEBUG, G_DEBUG and other environment	variables  supported  by
       glib.  <https://docs.gtk.org/glib/running.html>

     * PHOC_DEBUG: Comma separated list of debugging flags:

	  * help: Show a list of available debug flags

	  * auto-maximize: Maximize toplevels

	  * damage-tracking: Debug damage tracking

	  * damage-whole: Damage whole output on each frame

	  * no-quit: Don't quit when session ends

	  * touch-points: Debug touch points

	  * layer-shell: Debug layer shell

	  * cutouts: Debug display cutouts and notches

	  * disable-animations: Disable animations

	  * force-shell-reveal: Always reveal shell over fullscreen apps

	  * ignore-state: Ignore any saved output state

UDEV PROPERTIES
     Apart  from  the  udev  properties  for  wakeup  keys  documented	in  gmo-
     bile.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 re-
     leases.

SEE ALSO
     phoc.ini(5)   phoc.gsettings(5)   phoc-outputs-states(1)	 gmobile.udev(5)
     phosh(1) busctl

									  PHOC()

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=phoc&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help