]> git.ipfire.org Git - thirdparty/systemd.git/blame - man/systemd-path.xml
Merge pull request #8822 from fbuihuu/rfc-tmpfiles-safe-upstream
[thirdparty/systemd.git] / man / systemd-path.xml
CommitLineData
9a00f57a
LP
1<?xml version='1.0'?> <!--*-nxml-*-->
2<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76 3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
9a00f57a
LP
4
5<!--
572eb058 6 SPDX-License-Identifier: LGPL-2.1+
9a00f57a
LP
7-->
8
9<refentry id="systemd-path"
798d3a52
ZJS
10 xmlns:xi="http://www.w3.org/2001/XInclude">
11
12 <refentryinfo>
13 <title>systemd-path</title>
14 <productname>systemd</productname>
798d3a52
ZJS
15 </refentryinfo>
16
17 <refmeta>
18 <refentrytitle>systemd-path</refentrytitle>
19 <manvolnum>1</manvolnum>
20 </refmeta>
21
22 <refnamediv>
23 <refname>systemd-path</refname>
24 <refpurpose>List and query system and user paths</refpurpose>
25 </refnamediv>
26
27 <refsynopsisdiv>
28 <cmdsynopsis>
e12d446b
ZJS
29 <command>systemd-path</command>
30 <arg choice="opt" rep="repeat">OPTIONS</arg>
31 <arg choice="opt" rep="repeat">NAME</arg>
798d3a52
ZJS
32 </cmdsynopsis>
33 </refsynopsisdiv>
34
35 <refsect1>
36 <title>Description</title>
37
38 <para><command>systemd-path</command> may be used to query system
39 and user paths. The tool makes many of the paths described in
40 <citerefentry><refentrytitle>file-hierarchy</refentrytitle><manvolnum>7</manvolnum></citerefentry>
cd72d204 41 available for querying.</para>
798d3a52 42
b938cb90 43 <para>When invoked without arguments, a list of known paths and
798d3a52 44 their current values is shown. When at least one argument is
b938cb90 45 passed, the path with this name is queried and its value shown.
798d3a52 46 The variables whose name begins with <literal>search-</literal>
7ca41557 47 do not refer to individual paths, but instead to a list of
798d3a52
ZJS
48 colon-separated search paths, in their order of precedence.</para>
49 </refsect1>
50
51 <refsect1>
52 <title>Options</title>
53
54 <para>The following options are understood:</para>
55
56 <variablelist>
57 <varlistentry>
58 <term><option>--suffix=</option></term>
59
e12d446b 60 <listitem><para>Printed paths are suffixed by the specified string.</para></listitem>
798d3a52
ZJS
61 </varlistentry>
62
63 <xi:include href="standard-options.xml" xpointer="help" />
64 <xi:include href="standard-options.xml" xpointer="version" />
65 </variablelist>
66
67 </refsect1>
68
69 <refsect1>
70 <title>Exit status</title>
71
72 <para>On success, 0 is returned, a non-zero failure code
73 otherwise.</para>
74 </refsect1>
75
76 <refsect1>
77 <title>See Also</title>
78 <para>
79 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
80 <citerefentry><refentrytitle>file-hierarchy</refentrytitle><manvolnum>7</manvolnum></citerefentry>
81 </para>
82 </refsect1>
9a00f57a
LP
83
84</refentry>