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 OPc/CRetPWJWPwAAgWs5BA (envelope-from ) for ; Fri, 25 Mar 2022 12:52:55 +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 WKXdARetPWJajAAAG6o9tA (envelope-from ) for ; Fri, 25 Mar 2022 12:52:55 +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 A6F1511CFC for ; Fri, 25 Mar 2022 12:52:54 +0100 (CET) Received: from localhost ([::1]:46940 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nXiUv-0008Ef-Re for larch@yhetil.org; Fri, 25 Mar 2022 07:52:53 -0400 Received: from eggs.gnu.org ([209.51.188.92]:40264) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nXfpa-0001XP-NM for guix-patches@gnu.org; Fri, 25 Mar 2022 05:02:06 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:56197) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nXfpa-0000jd-EH for guix-patches@gnu.org; Fri, 25 Mar 2022 05:02:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nXfpa-0000fR-CN for guix-patches@gnu.org; Fri, 25 Mar 2022 05:02:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#54561] [PATCH 2/4] doc: Add "Samba" chapter. 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:02:02 +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.16481989152551 (code B ref 54561); Fri, 25 Mar 2022 09:02:02 +0000 Received: (at 54561) by debbugs.gnu.org; 25 Mar 2022 09:01:55 +0000 Received: from localhost ([127.0.0.1]:50094 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nXfpS-0000f5-Hj for submit@debbugs.gnu.org; Fri, 25 Mar 2022 05:01:54 -0400 Received: from smtprelay03.ispgateway.de ([80.67.31.26]:44828) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nXfpQ-0000ev-CB for 54561@debbugs.gnu.org; Fri, 25 Mar 2022 05:01:53 -0400 Received: from [93.195.170.97] (helo=milk) by smtprelay03.ispgateway.de with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1nXfpR-0001pv-Ga; Fri, 25 Mar 2022 10:01:53 +0100 From: Simon Streit Gcc: nnfolder+archive:sent.2022-03 Date: Fri, 25 Mar 2022 10:01:50 +0100 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=1648209174; 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=NjBYm5UsIAYCfDfJaF4VV2kY9Ao/kYX37KRatu6ukj8=; b=UM/PDWD500YS5HAJVJjwd8HfciUuc/7QJ/yCW/IQEc823iR5Xq/+Frs51Qe4g++vjsyDCv VDjI/0yM+Lwhg97WabPqRpGSsDMTYmPJrgKAhvVXHlEkDpUEaFEtdTRtKSiSvZlmpwAVAO rYT4qkvXNYpWF3utofQVlGQJB+js+8wW3CtIWM66S+PcqtJCg9DOXeSiUgGccMTBRCo4+f UpCdd/sfUqw887HlfheLHhT8HOA3DyJTGzo8Rl2leNUb8JIBbEs7v+dZqseMCBv/Io0/wq j7BWNmIYxlE6u9H9mry21M2H5LaQYyPfc0Lx0AQi4ojc18NGHfiFWEHA8AyKaw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1648209174; a=rsa-sha256; cv=none; b=MA814zQdUU2gvHItnhJwBxN8PYaP3tcDZ3isauWlQclscIfX9SuxRPXGDpCcTOnxBYrR6B DrYRkDb9qayXXBZAHhjucC4TYRAmAWyCGXw1sqBvDu9m0dMvr+nn6JOIJI1A6Tq6FSTVn1 d2YgYo1zyBxXPXwUCH5C2bwRPGal17S8cOcNCPACqYWaWIh26zDDMgd7qF3Fy3p0pxVpOx rnJzEzV3CVNNAPgixweMC8ngTJ31hAV57zBSxzcwNaqK4Z7lA38hcnKo0zNCAPw+GE4xr8 q5f0PrT9XbykEmImnSBmZ5/ZyNwC+4fMx0avLaNglI3PDd6cgeRQLiyUZpMueQ== 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: A6F1511CFC X-Spam-Score: -3.09 X-Migadu-Scanner: scn0.migadu.com X-TUID: 9dVSkv4bNMqz --- doc/guix.texi | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index e8ef4286be..270f07d068 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -101,6 +101,7 @@ Copyright @copyright{} 2021 Andrew Tropin@* Copyright @copyright{} 2021 Sarah Morgensen@* Copyright @copyright{} 2021 Josselin Poiret@* Copyright @copyright{} 2022 Remco van 't Veer@* +Copyright @copyright{} 2022 Simon Streit@* Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -368,6 +369,7 @@ Services * DNS Services:: DNS daemons. * VPN Services:: VPN daemons. * Network File System:: NFS related services. +* Samba Services:: Samba services. * Continuous Integration:: Cuirass and Laminar services. * Power Management Services:: Extending battery life. * Audio Services:: The MPD. @@ -29861,6 +29863,57 @@ The verbosity level of the daemon. @end table @end deftp +@node Samba Services, Continuous Integration, Network File System, Services +@subsection Samba Services + +@cindex samba +@cindex smb +The @code{(gnu services samba)} module provides Guix service definitions +for Samba as well as additional helper services. Currently it provides +the following services: + +@subsubheading Samba + +Samba provides network shares for folder and printers, it can also be an +AD DC for other samba hosts in an heterougenious network with different +types of Computer systems. + +@defvar{samba-service-type} + +The service type to enable the samba services @code{samba}, @code{nmbd}, +@code{smbd} and @code{winbindd}. By default this service type does not +run as an AD DC, hence @code{samba} remains disabled. It is recommended +that Samba's package is added to the system profile to have the tool-set +available for modifications in Samba's runtime directories. + +@end defvar + +@deftp{Data Type} samba-service-configuration +Configuration record for the Samba suite. + +@table @asis +@item @code{package} (default: @code{samba}) +The samba package to use. + +@item @code{config-file} (default: @code{#f}) +The config file to use. Please note: Setting this variable will disable +all config options that come after @code{enable-winbindd?}. + +@item @code{enable-samba?} (default: @code{#f}) +Manually enable the @code{samba} daemon. + +@item @code{enable-smbd?} (default: @code{#f}) +Manually enable the @code{smbd} daemon. + +@item @code{enable-nmbd?} (default: @code{#f}) +Manually enable the @code{nmbd} daemon. + +@item @code{enable-winbindd?} (default: @code{#f}) +Manually enable the @code{winbindd} daemon. + +@end table +@end deftp + @node Continuous Integration @subsection Continuous Integration -- 2.34.0