H.4. Installation directories

--prefix=PATH

This is a fairly standard option with GNU autoconf, and it sets the base path for most of the other install directories. The default is /usr/local/ups, which puts everything but the state sockets in one easy place, and does not conflict with usual distribution packaging.

If you like having things to be at more of a "system" level, setting the prefix to /usr/local or even /usr might be better.

--exec_prefix=PATH

This sets the base path for architecture dependent files. By default, it is the same as <prefix>.

--sysconfdir=PATH

Changes the location where NUT’s configuration files are stored. By default this path is <prefix>/etc. Setting this to /etc/nut or /etc/ups might be useful.

The NUT_CONFPATH environment variable overrides this at run time.

--sbindir=PATH
--bindir=PATH

Where executable files will be installed. Files that are normally executed by root (upsd, upsmon, upssched) go to <sbindir>, all others to <bindir>. The defaults are <exec_prefix>/sbin and <exec_prefix>/bin respectively.

See also --with-drvpath below.

--with-drvpath=PATH

The UPS drivers will be installed to this path. By default they install to <exec_prefix>/bin, i.e. /usr/local/ups/bin.

You would want a location that remains mounted when most of the system is prepared to turn off, so some distributions package NUT drivers into /lib/nut or similar. See config-notes.txt detailing how to set up system shutdown.

The driverpath global directive in the ups.conf file overrides this at run time.

--datadir=PATH

Change the data directory, i.e., where architecture independent read-only data is installed. By default this is <prefix>/share, i.e. /usr/local/ups/share. At the moment, this directory only holds two files — the optional cmdvartab and driver.list.

--mandir=PATH

Sets the base directories for the man pages. The default is <prefix>/man, i.e. /usr/local/ups/man.

--includedir=PATH

Sets the path for include files to be installed when --with-dev is selected. For example, upsclient.h is installed here. The default is <prefix>/include.

--libdir=PATH

Sets the installation path for libraries. Depending on the build configuration, this can include the libupsclient, libnutclient, libnutclientsub, libnutscan and their pkg-config metadata (see --with-pkgconfig-dir option). The default is <exec_prefix>/lib.

--with-pkgconfig-dir=PATH

Where to install pkg-config *.pc files. This option only has an effect if --with-dev is selected, and causes a pkg-config file to be installed in the named location. The default is <exec_prefix>/pkgconfig.

Use --without-pkgconfig-dir to disable this feature altogether.

--with-cgipath=PATH

The CGI programs will be installed to this path. By default, they install to <exec_prefix>/cgi-bin, which is usually /usr/local/ups/cgi-bin.

Note

If you set the prefix to something like /usr, you should set the cgipath to something else, because /usr/cgi-bin is pretty ugly and non-standard.

The CGI programs are not built or installed by default. Use ./configure --with-cgi to request that they are built and installed.

--with-htmlpath=PATH

HTML files will be installed to this path. By default, this is <prefix>/html. Note that HTML files are only installed if --with-cgi is selected.

--with-hotplug-dir=PATH

Where to install Linux 2.4 hotplugging rules. The default is to use /etc/hotplug, if that directory exists, and to not install it otherwise. Note that this installation directory is not a subdirectory of <prefix> by default. When installing NUT as a non-root user, you may have to override this option.

Use --without-hotplug-dir to disable this feature altogether.

--with-udev-dir=PATH

Where to install Linux 2.6 hotplugging rules, for kernels that have the "udev" mechanism. The default is to use /etc/udev, if that directory exists, and to not install it otherwise. Note that this installation directory is not a subdirectory of <prefix> by default. When installing NUT as a non-root user, you may have to override this option.

Use --without-udev-dir to disable this feature altogether.

--with-systemdsystemunitdir=PATH

Where to install Linux systemd unit definitions. Useless and harmless on other OSes, including Linux distributions without systemd, just adding a little noise to configure script output.

Use --with-systemdsystemunitdir=auto (default) to detect the settings using pkg-config if possible.

Use --with-systemdsystemunitdir(=yes) to require detection of these settings with pkg-config, or fail configuration if not possible.

Use --with-systemdsystemunitdir=no to disable this feature altogether.

--with-systemdshutdowndir=PATH

Where to install Linux systemd unit definitions for shutdown handling. Useless and harmless on other OSes, including Linux distributions without systemd, just adding a little noise to configure script output.

Use --with-systemdshutdowndir to detect the settings using pkg-config.

Use --with-systemdshutdowndir=no to disable this feature altogether.

--with-systemdtmpfilesdir=PATH

Where to install Linux systemd configuration for tmpfiles handling (the automatically created locations for PID, state and similar run-time files). Useless and harmless on other OSes, including Linux distributions without systemd, just adding a little noise to configure script output.

Use --with-systemdtmpfilesdir to detect the settings using pkg-config.

Use --with-systemdtmpfilesdir=no to disable this feature altogether.

--with-augeas-lenses-dir=PATH

Where to install Augeas configuration-management lenses.

Only useful and valid if you use Augeas to parse and modify configuration files. The default is to use /usr/share/augeas/lenses, if that directory exists, and to not install it otherwise.