Lennart Poettering
818bf54632
This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
101 lines
3.2 KiB
XML
101 lines
3.2 KiB
XML
<?xml version='1.0'?> <!--*- Mode: nxml; nxml-child-indent: 2; indent-tabs-mode: nil -*-->
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
|
|
|
<!--
|
|
SPDX-License-Identifier: LGPL-2.1+
|
|
|
|
Copyright 2016 Julian Orth
|
|
-->
|
|
|
|
<refentry id="sd_bus_message_read_basic">
|
|
|
|
<refentryinfo>
|
|
<title>sd_bus_message_read_basic</title>
|
|
<productname>systemd</productname>
|
|
|
|
<authorgroup>
|
|
<author>
|
|
<firstname>Julian</firstname>
|
|
<surname>Orth</surname>
|
|
<email>ju.orth@gmail.com</email>
|
|
</author>
|
|
</authorgroup>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>sd_bus_message_read_basic</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>sd_bus_message_read_basic</refname>
|
|
|
|
<refpurpose>Read a basic type from a message</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<funcsynopsis>
|
|
<funcsynopsisinfo>#include <systemd/sd-bus.h></funcsynopsisinfo>
|
|
|
|
<funcprototype>
|
|
<funcdef>int <function>sd_bus_message_read_basic</function></funcdef>
|
|
<paramdef>sd_bus_message *<parameter>m</parameter></paramdef>
|
|
<paramdef>char <parameter>type</parameter></paramdef>
|
|
<paramdef>void *<parameter>p</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para>
|
|
<function>sd_bus_message_read_basic()</function> reads a basic type from a
|
|
message and advances the read position in the message. The set of basic
|
|
types and their ascii codes passed in <parameter>type</parameter> are
|
|
described in the <ulink
|
|
url="https://dbus.freedesktop.org/doc/dbus-specification.html">D-Bus
|
|
Specification</ulink>.
|
|
</para>
|
|
|
|
<para>
|
|
If <parameter>p</parameter> is not NULL, it should contain a pointer to an
|
|
appropriate object. For example, if <parameter>type</parameter> is
|
|
<constant>'y'</constant>, the object passed in <parameter>p</parameter>
|
|
should have type <code>uint8_t *</code>. If <parameter>type</parameter>
|
|
is <constant>'s'</constant>, the object passed in <parameter>p</parameter>
|
|
should have type <code>const char **</code>. Note that, if the basic type
|
|
is a pointer (e.g., <code>const char *</code> in the case of a string),
|
|
the pointer is only borrowed and the contents must be copied if they are
|
|
to be used after the end of the messages lifetime. Similarly, during the
|
|
lifetime of such a pointer, the message must not be modified.
|
|
</para>
|
|
|
|
<para>
|
|
If there is no object of the specified type at the current position in the
|
|
message, an error is returned.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Return Value</title>
|
|
|
|
<para>
|
|
On success, <function>sd_bus_message_read_basic()</function> returns 0 or
|
|
a positive integer. On failure, it returns a negative errno-style error
|
|
code.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
|
|
<para>
|
|
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>sd-bus</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|