Skip to content
This repository was archived by the owner on Sep 16, 2021. It is now read-only.
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Makefile.am
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
SUBDIRS = libdleyna/renderer
SUBDIRS = doc libdleyna/renderer

if BUILD_SERVER
SUBDIRS += server
Expand Down
10 changes: 8 additions & 2 deletions configure.ac
Original file line number Diff line number Diff line change
Expand Up @@ -34,12 +34,17 @@ LT_PREREQ([2.2.6])
LT_INIT([dlopen disable-static])
LT_LANG([C])

AC_PATH_PROG([XSLTPROC], [xsltproc])
if test -z "$XSLTPROC"; then
AC_MSG_ERROR([xsltproc not found])
fi

# Checks for libraries.
PKG_PROG_PKG_CONFIG(0.16)
PKG_CHECK_MODULES([GLIB], [glib-2.0 >= 2.28])
PKG_CHECK_MODULES([GIO], [gio-2.0 >= 2.28])
PKG_CHECK_MODULES([GSSDP], [gssdp-1.0 >= 0.13.2])
PKG_CHECK_MODULES([GUPNP], [gupnp-1.0 >= 0.20.5])
PKG_CHECK_MODULES([GSSDP], [gssdp-1.2 >= 1.2.0])
PKG_CHECK_MODULES([GUPNP], [gupnp-1.2 >= 1.2.0])
PKG_CHECK_MODULES([GUPNPAV], [gupnp-av-1.0 >= 0.11.5])
PKG_CHECK_MODULES([GUPNPDLNA], [gupnp-dlna-2.0 >= 0.9.4])
PKG_CHECK_MODULES([SOUP], [libsoup-2.4 >= 2.28.2])
Expand Down Expand Up @@ -231,6 +236,7 @@ AC_SUBST([with_log_level])
AC_SUBST([with_log_type])

AC_CONFIG_FILES([Makefile \
doc/Makefile \
libdleyna/renderer/Makefile \
libdleyna/renderer/dleyna-renderer-service.conf \
server/dleyna-renderer-service-1.0.pc \
Expand Down
18 changes: 18 additions & 0 deletions doc/Makefile.am
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
XSLTPROC_FLAGS = \
--nonet \
--stringparam man.output.quietly 1 \
--stringparam funcsynopsis.style ansi \
--stringparam man.authors.section.enabled 0 \
--stringparam man.copyright.section.enabled 0

.xml.5:
$(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<

man_MANS = \
dleyna-renderer-service.conf.5

xml_files = $(man_MANS:.5=.xml)

EXTRA_DIST = $(xml_files)

CLEANFILES = $(man_MANS)
182 changes: 182 additions & 0 deletions doc/dleyna-renderer-service.conf.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,182 @@
<?xml version="1.0" encoding="UTF-8"?>
<refentry id="dleyna-renderer-service.conf.5">
<refentryinfo>
<title>dleyna-renderer-service.conf</title>
<date>June 2020</date>
<productname>dLeyna</productname>
</refentryinfo>

<refmeta>
<refentrytitle>dleyna-renderer-service.conf</refentrytitle>
<manvolnum>5</manvolnum>
<refmiscinfo class="manual">Linux Programmer's Manual</refmiscinfo>
</refmeta>

<refnamediv>
<refname>dleyna-renderer-service.conf</refname>
<refpurpose>Configuration file for dleyna-renderer</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>/etc/dleyna-renderer-service.conf</command>
</cmdsynopsis>
</refsynopsisdiv>


<refsect1>
<title>DESCRIPTION</title>
<para>
The <command>dleyna-renderer-service</command> program provides the
<emphasis>com.intel.dleyna-renderer</emphasis> name on the session
message bus. It is a service for discovering and manipulating DLNA
Digital Media Renderers (or DMRs).
</para>
<para>
Users or administrators should never need to start this daemon as it will
be automatically started by
<citerefentry><refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum></citerefentry>
whenever a process sends a D-Bus message to the
<emphasis>com.intel.dleyna-renderer</emphasis> name on the session bus.
</para>
<para>
This file can be used to configure the behaviour of the
<command>dleyna-renderer-service</command> program.
</para>
</refsect1>

<refsect1>
<title>FILE FORMAT</title>
<para>
The configuration file format is the so-called key file (sort of
ini-style) format. It consists of sections (or groups) of key-value
Lines beginning with a '#' and blank lines are considered comments.
Sections are started by a header line containing the section enclosed
in '[' and ']', and ended implicitly by the start of the next section
or the end of the file. Each key-value pair must be contained in a
section.
</para>
</refsect1>

<refsect1>
<title>GENERAL SECTION</title>
<variablelist>
<varlistentry>
<term><option>connector-name=dbus</option></term>
<listitem>
<para>
The name of the inter-process communication method to be used.
The only supported value is <emphasis>dbus</emphasis>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>never-quit=false|true</option></term>
<listitem>
<para>
Whether the process should stay alive forever or quit when the
last client disconnects. The default value is
<emphasis>false</emphasis>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>port</option></term>
<listitem>
<para>
Source port for Simple Service Discovery Protocol (or SSDP)
messages. The default value is <emphasis>0</emphasis> which
means that a random available port will be used.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>push-host-port</option></term>
<listitem>
<para>
Port for push host file server. The default value is
<emphasis>0</emphasis> which means that a random available
port will be used.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>LOG SECTION</title>
<variablelist>
<varlistentry>
<term><option>log-type=0|1|2</option></term>
<listitem>
<para>
The logging method to be used. Three technologies are supported.
0 for syslog, 1 for GLib, and 2 for file. The default value is
<emphasis>0</emphasis>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>log-level=0|1|2|...|8</option></term>
<listitem>
<para>
Comma-separated list of logging levels. The levels are 1 for
critical, 2 for error, 3 for warning, 4 for message, 5 for info
and 6 for debug. 0 excludes all levels, 7 is a combination of
critical, error and info, and 8 includes all levels.
</para>
<para>
The default value is <emphasis>7</emphasis>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>NETF SECTION</title>
<variablelist>
<varlistentry>
<term><option>netf-enabled=false|true</option></term>
<listitem>
<para>
Whether network filtering should be enabled or not. The default
values is <emphasis>false</emphasis>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>netf-list</option></term>
<listitem>
<para>
Comma-separated list of interface names, service set identifiers
(or SSIDs), and Internet Protocol (or IP) addresses. If network
filtering is requested but the list is empty, then filtering
remains disabled.
</para>
<para>
The list is empty by default.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>BUGS</title>
<para>
Please send bug reports to either the distribution bug tracker
or the upstream bug tracker at
<ulink url="https://github.com/intel/dleyna-renderer/issues"></ulink>.
</para>
</refsect1>

<refsect1>
<title>SEE ALSO</title>
<para>
<citerefentry>
<refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum>
</citerefentry>
</para>
</refsect1>
</refentry>
2 changes: 2 additions & 0 deletions libdleyna/renderer/Makefile.am
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ libdleyna_renderer_1_0_la_LDFLAGS = -version-info $(DLEYNA_RENDERER_VERSION) \
libdleyna_renderer_1_0_la_SOURCES = $(libdleyna_rendererinc_HEADERS) \
async.c \
device.c \
gasync-task.c \
host-service.c \
manager.c \
server.c \
Expand Down Expand Up @@ -53,6 +54,7 @@ sysconf_DATA = dleyna-renderer-service.conf
EXTRA_DIST = $(sysconf_DATA) \
async.h \
device.h \
gasync-task.h \
host-service.h \
prop-defs.h \
manager.h \
Expand Down
Loading