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

       --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.gsettings(5).   For	  details   on	output	states	see  phoc-out-
       puts-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  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)  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.0>

home | help