11a1589223
Files which are installed as-is (any .service and other unit files, .conf files, .policy files, etc), are left as is. My assumption is that SPDX identifiers are not yet that well known, so it's better to retain the extended header to avoid any doubt. I also kept any copyright lines. We can probably remove them, but it'd nice to obtain explicit acks from all involved authors before doing that.
197 lines
7.7 KiB
XML
197 lines
7.7 KiB
XML
<?xml version='1.0'?> <!--*-nxml-*-->
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
|
|
<!ENTITY % entities SYSTEM "custom-entities.ent" >
|
|
%entities;
|
|
]>
|
|
|
|
<!--
|
|
SPDX-License-Identifier: LGPL-2.1+
|
|
|
|
This file is part of systemd.
|
|
|
|
Copyright 2015 David Herrmann <dh.herrmann@gmail.com>
|
|
-->
|
|
|
|
<refentry id="udev_device_get_syspath"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude">
|
|
|
|
<refentryinfo>
|
|
<title>udev_device_get_syspath</title>
|
|
<productname>systemd</productname>
|
|
|
|
<authorgroup>
|
|
<author>
|
|
<contrib>Developer</contrib>
|
|
<firstname>David</firstname>
|
|
<surname>Herrmann</surname>
|
|
<email>dh.herrmann@gmail.com</email>
|
|
</author>
|
|
</authorgroup>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>udev_device_get_syspath</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>udev_device_get_syspath</refname>
|
|
<refname>udev_device_get_sysname</refname>
|
|
<refname>udev_device_get_sysnum</refname>
|
|
<refname>udev_device_get_devpath</refname>
|
|
<refname>udev_device_get_devnode</refname>
|
|
<refname>udev_device_get_devnum</refname>
|
|
<refname>udev_device_get_devtype</refname>
|
|
<refname>udev_device_get_subsystem</refname>
|
|
<refname>udev_device_get_driver</refname>
|
|
<refname>udev_device_get_udev</refname>
|
|
<refname>udev_device_get_parent</refname>
|
|
<refname>udev_device_get_parent_with_subsystem_devtype</refname>
|
|
<refname>udev_device_get_is_initialized</refname>
|
|
<refname>udev_device_get_action</refname>
|
|
|
|
<refpurpose>Query device properties</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>#include <libudev.h></funcsynopsisinfo>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_syspath</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_sysname</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_sysnum</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_devpath</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_devnode</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>dev_t <function>udev_device_get_devnum</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_devtype</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_subsystem</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_driver</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>struct udev *<function>udev_device_get_udev</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>struct udev_device *<function>udev_device_get_parent</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>struct udev_device *<function>udev_device_get_parent_with_subsystem_devtype</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
<paramdef>const char *<parameter>subsystem</parameter></paramdef>
|
|
<paramdef>const char *<parameter>devtype</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>int <function>udev_device_get_is_initialized</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
<funcprototype>
|
|
<funcdef>const char *<function>udev_device_get_action</function></funcdef>
|
|
<paramdef>struct udev_device *<parameter>udev_device</parameter></paramdef>
|
|
</funcprototype>
|
|
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<!--<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para>XXX: Add documentation.</para>
|
|
</refsect1>-->
|
|
|
|
<refsect1>
|
|
<title>Return Value</title>
|
|
|
|
<para>On success, <function>udev_device_get_syspath()</function>,
|
|
<function>udev_device_get_sysname()</function>,
|
|
<function>udev_device_get_sysnum()</function>,
|
|
<function>udev_device_get_devpath()</function>,
|
|
<function>udev_device_get_devnode()</function>,
|
|
<function>udev_device_get_devtype()</function>,
|
|
<function>udev_device_get_subsystem()</function>,
|
|
<function>udev_device_get_driver()</function> and
|
|
<function>udev_device_get_action()</function> return a pointer
|
|
to a constant string that describes the requested property. The
|
|
lifetime of this string is bound to the device it was requested
|
|
on. On failure, each function may return
|
|
<constant>NULL</constant>.</para>
|
|
|
|
<para>On success, <function>udev_device_get_devnum()</function>
|
|
returns the device type of the passed device. On failure, a
|
|
device type with minor and major number set to
|
|
<constant>0</constant> is returned.</para>
|
|
|
|
<para><function>udev_device_get_udev()</function> always returns
|
|
a valid pointer to the udev context that this device belongs
|
|
to.</para>
|
|
|
|
<para>On success, <function>udev_device_get_parent()</function>
|
|
and
|
|
<function>udev_device_get_parent_with_subsystem_devtype()</function>
|
|
return a pointer to the parent device. No additional reference
|
|
to this device is acquired, but the child device owns a reference
|
|
to such a parent device. On failure, <constant>NULL</constant>
|
|
is returned.</para>
|
|
|
|
<para>On success, <function>udev_device_get_is_initialized()</function> returns either <constant>1</constant> or
|
|
<constant>0</constant>, depending on whether the passed device has already been initialized by udev or not. On
|
|
failure, a negative error code is returned. Note that devices for which no udev rules are defined are never
|
|
reported initialized.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
|
|
<para>
|
|
<citerefentry><refentrytitle>udev_new</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>udev_device_new_from_syspath</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>udev_device_has_tag</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>udev_enumerate_new</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>udev_monitor_new_from_netlink</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>udev_list_entry</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|