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.

prints the short usage
prints the version
prints the full info page
prints the installation prefix
prints the installation exec-prefix
prints the installation bindir
prints the installation datadir
prints the installation libexecdir
prints the installation sysconfdir
prints the installation mandir
prints the installation localedir
prints FVWM_MODULEDIR, where the modules are installed
prints FVWM_DATADIR, where the system wide configs are installed
prints FVWM_PERLLIBDIR, where the perl library is installed
prints the built-in ImagePath
prints the default FVWM_USERDIR, note: $HOME is not expanded
prints the fvwm executable name (in bindir)
lists all supported features, one per line
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>

19 October 2022 (2.7.0) 3rd Berkeley Distribution