3
0
mirror of https://git.kernel.org/pub/scm/network/wireless/iwd.git synced 2024-12-22 13:02:44 +01:00

doc: Add manual page for debugging information

This commit is contained in:
Marcel Holtmann 2019-11-05 22:14:09 +01:00
parent 1365fc6820
commit c6f9e89748
4 changed files with 55 additions and 13 deletions

1
.gitignore vendored
View File

@ -20,6 +20,7 @@ autom4te.cache
ell ell
src/iwd src/iwd
src/iwd.8 src/iwd.8
src/iwd.debug.7
src/iwd.config.5 src/iwd.config.5
src/iwd.network.5 src/iwd.network.5
src/iwd.service src/iwd.service

View File

@ -159,7 +159,7 @@ if MANUAL_PAGES
man_MANS = man_MANS =
endif endif
manual_pages = src/iwd.8 src/iwd.config.5 src/iwd.network.5 \ manual_pages = src/iwd.8 src/iwd.debug.7 src/iwd.config.5 src/iwd.network.5 \
client/iwctl.1 monitor/iwmon.1 wired/ead.8 tools/hwsim.1 client/iwctl.1 monitor/iwmon.1 wired/ead.8 tools/hwsim.1
eap_sources = src/eap.c src/eap.h src/eap-private.h \ eap_sources = src/eap.c src/eap.h src/eap-private.h \
@ -256,7 +256,7 @@ systemd_network_DATA += src/80-iwd.link
endif endif
if MANUAL_PAGES if MANUAL_PAGES
man_MANS += src/iwd.8 src/iwd.config.5 src/iwd.network.5 man_MANS += src/iwd.8 src/iwd.debug.7 src/iwd.config.5 src/iwd.network.5
endif endif
endif endif
@ -642,6 +642,9 @@ endif
%.5: %.rst Makefile %.5: %.rst Makefile
$(RST2MAN_PROCESS) $(RST2MAN_PROCESS)
%.7: %.rst Makefile
$(RST2MAN_PROCESS)
%.8: %.rst Makefile %.8: %.rst Makefile
$(RST2MAN_PROCESS) $(RST2MAN_PROCESS)

44
src/iwd.debug.rst Normal file
View File

@ -0,0 +1,44 @@
===========
iwd.debug
===========
-----------------------------------------
Debugging information for wireless daemon
-----------------------------------------
:Author: Marcel Holtmann <marcel@holtmann.org>
:Author: Denis Kenzior <denkenz@gmail.com>
:Author: Andrew Zaborowski <andrew.zaborowski@intel.com>
:Author: Tim Kourt <tim.a.kourt@linux.intel.com>
:Author: James Prestwood <prestwoj@gmail.com>
:Copyright: 2013-2019 Intel Corporation
:Version: iwd
:Date: 22 September 2019
:Manual section: 7
:Manual group: Linux Connectivity
SYNOPSIS
========
Debugging information for wireless daemon
DESCRIPTION
===========
Common methods of obtaining extra debugging information.
ENVIRONMENT
===========
*$IWD_RTNL_DEBUG* set to ``1`` enables RTNL debugging.
*$IWD_DHCP_DEBUG* set to ``1`` enables DHCP debugging.
*$IWD_TLS_DEBUG* set to ``1`` enables TLS debugging.
*$IWD_WSC_DEBUG_KEYS* set to ``1`` enables WSC debug keys.
SEE ALSO
========
iwd(8),

View File

@ -44,25 +44,19 @@ OPTIONS
ENVIRONMENT ENVIRONMENT
=========== ===========
*$STATE_DIRECTORY* is used for network configuration files. See section *$STATE_DIRECTORY* is used for network configuration files. See *iwd.network*
*iwd.network* for details. for details.
*$CONFIGURATION_DIRECTORY* is used for daemon configuration settings. Only *$CONFIGURATION_DIRECTORY* is used for daemon configuration settings. Only
the file **main.conf** is currently read from this directory. See *iwd.config* the file **main.conf** is currently read from this directory. See *iwd.config*
for details. for details.
*$IWD_RTNL_DEBUG* set to ``1`` enables RTNL debugging. See *iwd.debug* for further environment variables for debugging.
*$IWD_DHCP_DEBUG* set to ``1`` enables DHCP debugging.
*$IWD_TLS_DEBUG* set to ``1`` enables TLS debugging.
*$IWD_WSC_DEBUG_KEYS* set to ``1`` enables WSC debug keys.
SEE ALSO SEE ALSO
======== ========
iwd.config(5), iwd.network(5), iwctl(1), iwmon(1), hwsim(1), ead(8), iwd.config(5), iwd.network(5), iwd.debug(7), iwctl(1), iwmon(1), hwsim(1),
systemd.exec(5) ead(8), systemd.exec(5)
http://iwd.wiki.kernel.org http://iwd.wiki.kernel.org