From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id OA50GICsPWIJQAAAgWs5BA (envelope-from ) for ; Fri, 25 Mar 2022 12:50:24 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id sJwGEYCsPWJ+XwAAG6o9tA (envelope-from ) for ; Fri, 25 Mar 2022 12:50:24 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id DF01C11CE3 for ; Fri, 25 Mar 2022 12:50:23 +0100 (CET) Received: from localhost ([::1]:42352 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nXiSU-000529-Jd for larch@yhetil.org; Fri, 25 Mar 2022 07:50:22 -0400 Received: from eggs.gnu.org ([209.51.188.92]:40466) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nXfqY-0002hR-FA for guix-patches@gnu.org; Fri, 25 Mar 2022 05:03:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:56201) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nXfqY-0000qD-6w for guix-patches@gnu.org; Fri, 25 Mar 2022 05:03:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nXfqY-0000h3-06 for guix-patches@gnu.org; Fri, 25 Mar 2022 05:03:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#54561] [PATCH 3/4] doc: Add documentation for WSDD service. References: In-Reply-To: Resent-From: Simon Streit Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Fri, 25 Mar 2022 09:03:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54561 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 54561@debbugs.gnu.org Received: via spool by 54561-submit@debbugs.gnu.org id=B54561.16481989762652 (code B ref 54561); Fri, 25 Mar 2022 09:03:01 +0000 Received: (at 54561) by debbugs.gnu.org; 25 Mar 2022 09:02:56 +0000 Received: from localhost ([127.0.0.1]:50098 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nXfqR-0000gh-Vr for submit@debbugs.gnu.org; Fri, 25 Mar 2022 05:02:56 -0400 Received: from smtprelay04.ispgateway.de ([80.67.31.32]:15569) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nXfqQ-0000ga-I4 for 54561@debbugs.gnu.org; Fri, 25 Mar 2022 05:02:55 -0400 Received: from [93.195.170.97] (helo=milk) by smtprelay04.ispgateway.de with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1nXfqb-0007RG-Ky; Fri, 25 Mar 2022 10:03:05 +0100 From: Simon Streit Date: Thu, 24 Mar 2022 22:10:05 +0100 Gcc: nnfolder+archive:sent.2022-03 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Df-Sender: bGlzdHNAbmV0cGFuaWMub3Jn X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Mailman-Approved-At: Fri, 25 Mar 2022 07:49:33 -0400 X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1648209024; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:resent-cc:resent-from:resent-sender: resent-message-id:in-reply-to:in-reply-to:references:references: list-id:list-help:list-unsubscribe:list-subscribe:list-post; bh=u+aGkJ0BdWkhwAPSd8Iw9z8JZiixS5Yam4DkwcdcNFI=; b=COyD62TWorIO+F5V9WOyFbq+o8Hebe5oQhyC1fTKpPZncvhcr96rgPLsudTF67f4Nr2nKK Vo0FQ+PtL3Fmu59iLSQ8j3vrufk1Da95pK9NCp+tkrvuJ8ABV0AWNaxzfbXNQFHn9Atb78 ynQN8Ti+z3OxpE+sKT2BFE0a5ArMCT3wq5oTHJvazSHvSUK16tY8b2IWaWGB/H2kIzvBwv Edp6NKvV+PHa3LOqt3JOUn56YjKUw8V3Eoc+CxkmYcJQHgHD9ZjwqMYp1E0S2a+mJvHtvx 5+vrT8IkNZ5VAllqkkjL0UfbnUPHdddJcAXXXyrtEAkHXLP2b7T2vKx+NZsrjA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1648209024; a=rsa-sha256; cv=none; b=I3+gBFr2TdeBYvCJ+Uw0uXVVPUHjDqCTrYp8Mdz+k0idDm19ar5zUwygx3dh0ATLwdL837 +rGeBZBdFevX6WDzvo0/zGJ5SnBuHKYL6M0M6vzhJZPRG5X/v7ZNhkmeBoQtz2E9bciNrH F7kN4AcyjfC1aCnREW24NVWbv2mxeMeALmrGnCpa/epwb7EFoHZWWvvnNAmUW42Qu9ylfD mFYAy/l2l+mO4gOzLZGwPR9szd0f+j9meIPX48iDX3r8asn+6pPILOH7pQuo1ZZuWo5bwp 6Ut+RzBo5JUEUDGF4IzI3yVLWrTyujsxviKgNGLxgh3GvJi47lqHMuAr6AtlWw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.09 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: DF01C11CE3 X-Spam-Score: -3.09 X-Migadu-Scanner: scn0.migadu.com X-TUID: Z907jMzuSeAU --- doc/guix.texi | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 270f07d068..9770856050 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -29914,6 +29914,72 @@ Manually enable the @code{winbindd} daemon. @end table @end deftp +@cindex wsdd +@subsubheading Web Service Discovery Daemon + +Web Service Discovery Daemon implements the WSD protocoll. It is a +drop-in replacement for host discovery that lack support for the SMBv1 +protocol. + +@defvr{Scheme Variable} wsdd-service-type + +Service type for the Web Service Discoery host daemon. The value for +this service type is a @code{wsdd-configuration} record. The details +for the @code{wsdd-configuration} record type are given below. +@end defvr + +@deftp{Data Type} wsdd-configuration This data type represents the +configuration for the wsdd service. + +@table @asis + +@item @code{package} (default: @code{wsdd}) +The wsdd package to use. + +@item @code{ipv4only?} (default: @code{#f}) +Only listen to ipv4 addresses. + +@item @code{ipv6only} (default: @code{#f}) +Only listen to ipv6 addresses. Please note: Activating both options is +not possible, since there would be no ip versions to listen to. + +@item @code{chroot} (default: @code{#f}) +Chroot into a sperate directory to prevent access to other directories. +This is to increase security in case there is a vulnerability in +@command{wsdd}. + +@item @code{hoplimit} (default: @code{1}) +Limit to the level of hops for multicast packets. The default is +@var{1} which should prevent packets from leaving the local network. + +@item @code{interface} (default: @code{'()}) +Limit to the given list of interfaces to listen to. By default wsdd +will listen to all interfaces. Except the loopback interface is never +used. + +@item @code{uuid-device} (default: @code{#f}) +The WSD protocol requires a device to have a UUID. Set this to manually +assign the service a UUID. + +@item @code{domain} (default: @code{#f}) +Notify this host is a member of an Active Directory. + +@item @code{hostname} (default: @code{#f}) +Manually set the hostname rather than letting @command{wsdd} inherit +this host's hostname. + +@item @code{preserve-case?} (default: @code{#f}) +By default @command{wsdd} will convert the hostname in workgroup to all +uppercase. The opposite is true for hostnames in domains. Setting this +parameter will preserve case. + +@item @code{workgroup} (default: @var{"WORKGROUP"}) +Change the name of the workgroup. By default @command{wsdd} reports +this host being member of a workgroup. + +@end table +@end deftp + @node Continuous Integration @subsection Continuous Integration -- 2.34.0