man-pages/man3/udev_device_get_syspath.3.html
2021-03-31 01:06:50 +01:00

162 lines
5.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of UDEV_DEVICE_GET_SYSPATH</TITLE>
</HEAD><BODY>
<H1>UDEV_DEVICE_GET_SYSPATH</H1>
Section: udev_device_get_syspath (3)<BR>Updated: <BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
udev_device_get_syspath, udev_device_get_sysname, udev_device_get_sysnum, udev_device_get_devpath, udev_device_get_devnode, udev_device_get_devnum, udev_device_get_devtype, udev_device_get_subsystem, udev_device_get_driver, udev_device_get_udev, udev_device_get_parent, udev_device_get_parent_with_subsystem_devtype, udev_device_get_is_initialized, udev_device_get_action - Query device properties
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<P>
<B>
</B><PRE>
#include &lt;<A HREF="file:///usr/include/libudev.h">libudev.h</A>&gt;
</PRE>
<DL COMPACT>
<DT id="1">
<B>const char *udev_device_get_syspath(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="2">
<B>const char *udev_device_get_sysname(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="3">
<B>const char *udev_device_get_sysnum(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="4">
<B>const char *udev_device_get_devpath(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="5">
<B>const char *udev_device_get_devnode(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="6">
<B>dev_t udev_device_get_devnum(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="7">
<B>const char *udev_device_get_devtype(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="8">
<B>const char *udev_device_get_subsystem(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="9">
<B>const char *udev_device_get_driver(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="10">
<B>struct udev *udev_device_get_udev(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="11">
<B>struct udev_device *udev_device_get_parent(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="12">
<B>struct udev_device *udev_device_get_parent_with_subsystem_devtype(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>, const&nbsp;char&nbsp;*</B><I>subsystem</I><B>, const&nbsp;char&nbsp;*</B><I>devtype</I><B>);</B>
<DT id="13">
<B>int udev_device_get_is_initialized(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
<DT id="14">
<B>const char *udev_device_get_action(struct&nbsp;udev_device&nbsp;*</B><I>udev_device</I><B>);</B>
</DL>
<A NAME="lbAD">&nbsp;</A>
<H2>RETURN VALUE</H2>
<P>
<DD>On success,
<B>udev_device_get_syspath()</B>,
<B>udev_device_get_sysname()</B>,
<B>udev_device_get_sysnum()</B>,
<B>udev_device_get_devpath()</B>,
<B>udev_device_get_devnode()</B>,
<B>udev_device_get_devtype()</B>,
<B>udev_device_get_subsystem()</B>,
<B>udev_device_get_driver()</B>
and
<B>udev_device_get_action()</B>
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
<B>NULL</B>.
<P>
On success,
<B>udev_device_get_devnum()</B>
returns the device type of the passed device. On failure, a device type with minor and major number set to
<B>0</B>
is returned.
<P>
<B>udev_device_get_udev()</B>
always returns a valid pointer to the udev context that this device belongs to.
<P>
On success,
<B>udev_device_get_parent()</B>
and
<B>udev_device_get_parent_with_subsystem_devtype()</B>
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,
<B>NULL</B>
is returned.
<P>
On success,
<B>udev_device_get_is_initialized()</B>
returns either
<B>1</B>
or
<B>0</B>, 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.
<A NAME="lbAE">&nbsp;</A>
<H2>SEE ALSO</H2>
<P>
<B><A HREF="/cgi-bin/man/man2html?3+udev_new">udev_new</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?3+udev_device_new_from_syspath">udev_device_new_from_syspath</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?3+udev_device_has_tag">udev_device_has_tag</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?3+udev_enumerate_new">udev_enumerate_new</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?3+udev_monitor_new_from_netlink">udev_monitor_new_from_netlink</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?3+udev_list_entry">udev_list_entry</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?1+systemd">systemd</A></B>(1),
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="15"><A HREF="#lbAB">NAME</A><DD>
<DT id="16"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="17"><A HREF="#lbAD">RETURN VALUE</A><DD>
<DT id="18"><A HREF="#lbAE">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:59 GMT, March 31, 2021
</BODY>
</HTML>