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 li-
       brary. 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 con-
       figuration 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:

       • 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

	    • 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

UDEV PROPERTIES
       Apart from the udev properties  for  wakeup  keys  documented  in  gmo-
       bile.udev(5)  phoc  uses	 ID_INPUT_KEYBOARD  to	identify hardware key-
       boards. 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

									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+14.3.quarterly>

home | help