Scroll to navigation

fvwm-config(1) Fvwm Modules fvwm-config(1)

NAME

fvwm-config - query an existing fvwm installation

SYNOPSIS

fvwm-config [--help] [--version] [--info] [--prefix] [--exec-prefix] [--bindir] [--datadir] [--libexecdir] [--sysconfdir] [--mandir] [--localedir] [--fvwm-moduledir] [--fvwm-datadir] [--fvwm-perllibdir] [--default-imagepath] [--default-userdir] [--fvwm-exe] [--supports] [--supports-<feature>]

DESCRIPTION

fvwm-config is a shell script that provides an information about the fvwm version, installation directories, built-in paths and supported features.

OPTIONS

fvwm-config prints to the standard output in all options. Both short and long GNU-like option names may be used.
-h --help -?
prints the short usage
-v --version -V
prints the version
-i --info
prints the full info page
-P --prefix
prints the installation prefix
-E --exec-prefix
prints the installation exec-prefix
-B --bindir
prints the installation bindir
-D --datadir
prints the installation datadir
-L --libexecdir
prints the installation libexecdir
-S --sysconfdir
prints the installation sysconfdir
-M --mandir
prints the installation mandir
-O --localedir
prints the installation localedir
-m --fvwm-moduledir
prints FVWM_MODULEDIR, where the modules are installed
-d --fvwm-datadir
prints FVWM_DATADIR, where the system wide configs are installed
-p --fvwm-perllibdir
prints FVWM_PERLLIBDIR, where the perl library is installed
-I --default-imagepath
prints the built-in ImagePath
-U --default-userdir
prints the default FVWM_USERDIR, note: $HOME is not expanded
-e --fvwm-exe
prints the fvwm executable name (in bindir)
-s --supports
lists all supported features, one per line
--supports-<feature>
prints nothing, returns: 0 if the <feature> is supported, 100 if not, 200 if unknown. All or supported feature names may be found using --info or --supports respectively.

USAGE

Here are some real life usages.

Checks for xft support:

if fvwm-config --supports-xft;
  then echo 1; else echo 0; fi

fvwm-themes package checks for the correct fvwm version installed using:

fvwm-config --version

and tries to use the same installation directories:
fvwm-config --bindir --mandir --fvwm-datadir

A way to find the full path to the fvwm executable:

echo `fvwm-config --bindir`/`fvwm-config --fvwm-exe`

A way to start modules in perl:

use lib `fvwm-config -p | tr -d '0`;
use FVWM::Module;

For a more human readable output, try:

fvwm-config --info

COPYING

fvwm-config is a part of fvwm package and distributed by the same terms, see GNU GPL.

AUTHOR

Mikhael Goikhman <migo@homemail.com>
06 November 2016 (2.6.8) 3rd Berkeley Distribution