06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann<?xml version='1.0'?> <!--*-nxml-*-->
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann<!ENTITY % entities SYSTEM "custom-entities.ent" >
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann%entities;
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann]>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann<!--
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann This file is part of systemd.
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann Copyright 2015 David Herrmann <dh.herrmann@gmail.com>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann systemd is free software; you can redistribute it and/or modify it
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann under the terms of the GNU Lesser General Public License as published by
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann the Free Software Foundation; either version 2.1 of the License, or
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann (at your option) any later version.
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann systemd is distributed in the hope that it will be useful, but
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann WITHOUT ANY WARRANTY; without even the implied warranty of
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann Lesser General Public License for more details.
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann You should have received a copy of the GNU Lesser General Public License
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann along with systemd; If not, see <http://www.gnu.org/licenses/>.
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann-->
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann<refentry id="udev_list_entry"
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann xmlns:xi="http://www.w3.org/2001/XInclude">
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refentryinfo>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <title>udev_list_entry</title>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <productname>systemd</productname>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <authorgroup>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <author>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <contrib>Developer</contrib>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <firstname>David</firstname>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <surname>Herrmann</surname>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <email>dh.herrmann@gmail.com</email>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </author>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </authorgroup>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </refentryinfo>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refmeta>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refentrytitle>udev_list_entry</refentrytitle>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <manvolnum>3</manvolnum>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </refmeta>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refnamediv>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refname>udev_list_entry</refname>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refname>udev_list_entry_get_next</refname>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refname>udev_list_entry_get_by_name</refname>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refname>udev_list_entry_get_name</refname>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refname>udev_list_entry_get_value</refname>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refpurpose>Iterate and access udev lists</refpurpose>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </refnamediv>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refsynopsisdiv>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcsynopsis>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcsynopsisinfo>#include &lt;libudev.h&gt;</funcsynopsisinfo>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcprototype>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcdef>struct udev_list_entry *<function>udev_list_entry_get_next</function></funcdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <paramdef>struct udev_list_entry *<parameter>list_entry</parameter></paramdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </funcprototype>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcprototype>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcdef>struct udev_list_entry *<function>udev_list_entry_get_by_name</function></funcdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <paramdef>struct udev_list_entry *<parameter>list_entry</parameter></paramdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <paramdef>const char *<parameter>name</parameter></paramdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </funcprototype>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcprototype>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcdef>const char *<function>udev_list_entry_get_name</function></funcdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <paramdef>struct udev_list_entry *<parameter>list_entry</parameter></paramdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </funcprototype>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcprototype>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <funcdef>const char *<function>udev_list_entry_get_value</function></funcdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <paramdef>struct udev_list_entry *<parameter>list_entry</parameter></paramdef>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </funcprototype>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </funcsynopsis>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </refsynopsisdiv>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <!--<refsect1>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <title>Description</title>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <para>XXX: Add short description.</para>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </refsect1>-->
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refsect1>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <title>Return Value</title>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <para>On success,
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <function>udev_list_entry_get_next()</function> and
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <function>udev_list_entry_get_by_name()</function> return
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann a pointer to the requested list entry. If no such entry can
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann be found, or on failure, <constant>NULL</constant> is
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann returned.</para>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <para>On success,
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <function>udev_list_entry_get_name()</function> and
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <function>udev_list_entry_get_value()</function> return a
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann pointer to a constant string representing the requested value.
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt The string is bound to the lifetime of the list entry itself.
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann On failure, <constant>NULL</constant> is returned.</para>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </refsect1>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <refsect1>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <title>See Also</title>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <para>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <citerefentry><refentrytitle>udev_new</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <citerefentry><refentrytitle>udev_device_new_from_syspath</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <citerefentry><refentrytitle>udev_enumerate_new</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <citerefentry><refentrytitle>udev_monitor_new_from_netlink</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </para>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann </refsect1>
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann
06255d6f76f3f630a9634d745a48910b1ea3e4d3David Herrmann</refentry>