HALF ECHO LEARN / REFERENCE COLLECTION

v262.2

man/systemd-path.xml

3,017 bytesGit mode 100644Download original fileLGPL-2.1-or-later

Git blob: 16f792794932e74a5dab4bc2585b3b50be6a855b

Lines 1–91 of 91

<?xml version='1.0'?> <!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
 
<refentry id="systemd-path"
    xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <refentryinfo>
    <title>systemd-path</title>
    <productname>systemd</productname>
  </refentryinfo>
 
  <refmeta>
    <refentrytitle>systemd-path</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>
 
  <refnamediv>
    <refname>systemd-path</refname>
    <refpurpose>List and query system and user paths</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>systemd-path</command>
      <arg choice="opt" rep="repeat">OPTIONS</arg>
      <arg choice="opt" rep="repeat">NAME</arg>
    </cmdsynopsis>
  </refsynopsisdiv>
 
  <refsect1>
    <title>Description</title>
 
    <para><command>systemd-path</command> may be used to query system
    and user paths. The tool makes many of the paths described in
    <citerefentry><refentrytitle>file-hierarchy</refentrytitle><manvolnum>7</manvolnum></citerefentry>
    available for querying.</para>
 
    <para>When invoked without arguments, a list of known paths and
    their current values is shown. When at least one argument is
    passed, the path with this name is queried and its value shown.
    The variables whose name begins with <literal>search-</literal>
    do not refer to individual paths, but instead to a list of
    colon-separated search paths, in their order of precedence.</para>
 
    <para>Note that paths which depend on environment variables are
    computed with <command>systemd-path</command>'s invoked
    environment, and not the system or user manager's environment. As
    such, the output of <command>systemd-path</command> may not
    reflect the behavior of manager processes.</para>
  </refsect1>
 
  <refsect1>
    <title>Options</title>
 
    <para>The following options are understood:</para>
 
    <variablelist>
      <varlistentry>
        <term><option>--suffix=</option></term>
 
        <listitem><para>Printed paths are suffixed by the specified string.</para>
 
        <xi:include href="version-info.xml" xpointer="v215"/></listitem>
      </varlistentry>
 
      <xi:include href="standard-options.xml" xpointer="no-pager"/>
      <xi:include href="standard-options.xml" xpointer="help" />
      <xi:include href="standard-options.xml" xpointer="version" />
    </variablelist>
 
  </refsect1>
 
  <refsect1>
    <title>Exit status</title>
 
    <para>On success, 0 is returned, a non-zero failure code
    otherwise.</para>
  </refsect1>
 
  <refsect1>
    <title>See Also</title>
    <para><simplelist type="inline">
      <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
      <member><citerefentry><refentrytitle>file-hierarchy</refentrytitle><manvolnum>7</manvolnum></citerefentry></member>
    </simplelist></para>
  </refsect1>
 
</refentry>