man/systemd-path.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4
   5 <!--
   6   SPDX-License-Identifier: LGPL-2.1+
   7
   8   This file is part of systemd.
   9
  10   Copyright 2014 Lennart Poettering
  11 -->
  12
  13 <refentry id="systemd-path"
  14     xmlns:xi="http://www.w3.org/2001/XInclude">
  15
  16   <refentryinfo>
  17     <title>systemd-path</title>
  18     <productname>systemd</productname>
  19
  20     <authorgroup>
  21       <author>
  22         <contrib>Developer</contrib>
  23         <firstname>Lennart</firstname>
  24         <surname>Poettering</surname>
  25         <email>lennart@poettering.net</email>
  26       </author>
  27     </authorgroup>
  28   </refentryinfo>
  29
  30   <refmeta>
  31     <refentrytitle>systemd-path</refentrytitle>
  32     <manvolnum>1</manvolnum>
  33   </refmeta>
  34
  35   <refnamediv>
  36     <refname>systemd-path</refname>
  37     <refpurpose>List and query system and user paths</refpurpose>
  38   </refnamediv>
  39
  40   <refsynopsisdiv>
  41     <cmdsynopsis>
  42       <command>systemd-path <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="opt" rep="repeat">NAME</arg></command>
  43     </cmdsynopsis>
  44   </refsynopsisdiv>
  45
  46   <refsect1>
  47     <title>Description</title>
  48
  49     <para><command>systemd-path</command> may be used to query system
  50     and user paths. The tool makes many of the paths described in
  51     <citerefentry><refentrytitle>file-hierarchy</refentrytitle><manvolnum>7</manvolnum></citerefentry>
  52     available for querying.</para>
  53
  54     <para>When invoked without arguments, a list of known paths and
  55     their current values is shown. When at least one argument is
  56     passed, the path with this name is queried and its value shown.
  57     The variables whose name begins with <literal>search-</literal>
  58     do not refer to individual paths, but instead to a list of
  59     colon-separated search paths, in their order of precedence.</para>
  60   </refsect1>
  61
  62   <refsect1>
  63     <title>Options</title>
  64
  65     <para>The following options are understood:</para>
  66
  67     <variablelist>
  68       <varlistentry>
  69         <term><option>--suffix=</option></term>
  70
  71         <listitem><para>The printed paths are suffixed by the
  72         specified string.</para></listitem>
  73       </varlistentry>
  74
  75       <xi:include href="standard-options.xml" xpointer="help" />
  76       <xi:include href="standard-options.xml" xpointer="version" />
  77     </variablelist>
  78
  79   </refsect1>
  80
  81   <refsect1>
  82     <title>Exit status</title>
  83
  84     <para>On success, 0 is returned, a non-zero failure code
  85     otherwise.</para>
  86   </refsect1>
  87
  88   <refsect1>
  89     <title>See Also</title>
  90     <para>
  91       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  92       <citerefentry><refentrytitle>file-hierarchy</refentrytitle><manvolnum>7</manvolnum></citerefentry>
  93     </para>
  94   </refsect1>
  95
  96 </refentry>