From patchwork Tue Dec 3 12:46:29 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Robert Vollmert X-Patchwork-Id: 16356 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 5771117831; Tue, 3 Dec 2019 13:07:14 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTP id 1141E1782E for ; Tue, 3 Dec 2019 13:07:14 +0000 (GMT) Received: from localhost ([::1]:53072 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ic7tZ-0000IU-B8 for patchwork@mira.cbaines.net; Tue, 03 Dec 2019 08:07:13 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:53414) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ic7c6-0002fQ-36 for guix-patches@gnu.org; Tue, 03 Dec 2019 07:49:12 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ic7c2-0001LW-If for guix-patches@gnu.org; Tue, 03 Dec 2019 07:49:09 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:33410) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ic7bz-0001Im-MH for guix-patches@gnu.org; Tue, 03 Dec 2019 07:49:06 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ic7bx-0002cA-J1 for guix-patches@gnu.org; Tue, 03 Dec 2019 07:49:01 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#38429] [PATCH 1/5] document scron References: <20191129175356.12403-1-rob@vllmrt.net> In-Reply-To: <20191129175356.12403-1-rob@vllmrt.net> Resent-From: Robert Vollmert Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 03 Dec 2019 12:49:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 38429 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 38429@debbugs.gnu.org Cc: Robert Vollmert Received: via spool by 38429-submit@debbugs.gnu.org id=B38429.15753773109983 (code B ref 38429); Tue, 03 Dec 2019 12:49:01 +0000 Received: (at 38429) by debbugs.gnu.org; 3 Dec 2019 12:48:30 +0000 Received: from localhost ([127.0.0.1]:39373 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ic7bS-0002aq-0I for submit@debbugs.gnu.org; Tue, 03 Dec 2019 07:48:30 -0500 Received: from mout-p-101.mailbox.org ([80.241.56.151]:37264) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ic7bP-0002aX-Bw for 38429@debbugs.gnu.org; Tue, 03 Dec 2019 07:48:28 -0500 Received: from smtp1.mailbox.org (smtp1.mailbox.org [IPv6:2001:67c:2050:105:465:1:1:0]) (using TLSv1.2 with cipher ECDHE-RSA-CHACHA20-POLY1305 (256/256 bits)) (No client certificate requested) by mout-p-101.mailbox.org (Postfix) with ESMTPS id 47S1xH00qwzKmhD; Tue, 3 Dec 2019 13:48:19 +0100 (CET) X-Virus-Scanned: amavisd-new at heinlein-support.de Received: from smtp1.mailbox.org ([80.241.60.240]) by spamfilter01.heinlein-hosting.de (spamfilter01.heinlein-hosting.de [80.241.56.115]) (amavisd-new, port 10030) with ESMTP id sRLwjYcAnGsl; Tue, 3 Dec 2019 13:48:15 +0100 (CET) From: Robert Vollmert Date: Tue, 3 Dec 2019 13:46:29 +0100 Message-Id: <20191203124632.1987-1-rob@vllmrt.net> MIME-Version: 1.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" X-getmail-retrieved-from-mailbox: Patches * doc/guix.texi: Add documentation for scron-service. --- The first in a series of supplementary patches on top of the base scron service patch, to be squashed into that commit. doc/guix.texi | 100 +++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 99 insertions(+), 1 deletion(-) diff --git a/doc/guix.texi b/doc/guix.texi index e0b831c7e8..1aafa01166 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -283,7 +283,7 @@ System Configuration Services * Base Services:: Essential system services. -* Scheduled Job Execution:: The mcron service. +* Scheduled Job Execution:: Cron services. * Log Rotation:: The rottlog service. * Networking Services:: Network setup, SSH daemon, etc. * X Window:: Graphical display. @@ -12890,6 +12890,104 @@ specifications,, mcron, GNU@tie{}mcron}). @end deftp +@cindex scron +@cindex scheduling jobs +The @code{(gnu services scron)} module provides an interface to +scron, a simple daemon to run jobs at scheduled times. scron is +similar to the traditional Unix @command{cron} daemon; +the main difference is that it is much simpler. + +Jobs are executed as root via the shell with working direction @code{/}. +Use @code{su(1)} or corresponding Guile functions +(@pxref{Processes,,, guile, GNU Guile Reference Manual}). + +The example below defines an operating system that runs the +@command{updatedb} (@pxref{Invoking updatedb,,, find, Finding Files}) +and the @command{guix gc} commands (@pxref{Invoking guix gc}) daily, as +well as the @command{mkid} command on behalf of an unprivileged user +(@pxref{mkid invocation,,, idutils, ID Database Utilities}). + +@lisp +(use-modules (guix) (gnu) (gnu services scron)) +(use-package-modules base idutils) + +(define updatedb-job + ;; Run 'updatedb' at 3AM every day. Here we write the + ;; job's action as a Scheme procedure. + (let* + ((exp #~(begin + (execl (string-append #$findutils "/bin/updatedb") + "updatedb" + "--prunepaths=/tmp /var/tmp /gnu/store"))) + (script (program-file "updatedb-job" exp)) + (scron-job + (schedule "0 3 * * *") + (command script)))) + +(define garbage-collector-job + ;; Collect garbage 5 minutes after midnight every day. + ;; The job's action is a shell command. + (scron-job + (schedule "5 0 * * *") + (command "guix gc -F 1G"))) + +(define idutils-job + ;; Update the index database as user "charlie" at 12:15PM + ;; and 19:15PM. This runs from the user's home directory. + (let* + ((cmd #~(string-append #$idutils "/bin/mkid src")) + (cmd-su #~(string-append "su -c '" #$cmd "' charlie"))) + (scron-job + (schedule "15 12,19 * * *") + (command cmd-su)))) + +(operating-system + ;; @dots{} + (services (cons (service scron-service-type + (scron-configuration + (jobs (list garbage-collector-job + updatedb-job + idutils-job)))) + %base-services))) +@end lisp + +@defvr {Scheme Variable} scron-service-type + +This is the type of the @code{scron} service, whose value is an +@code{scron-configuration} object. + +This service type can be the target of a service extension that provides +it additional job specifications (@pxref{Service Composition}). In +other words, it is possible to define services that provide additional +mcron jobs to run. +@end defvr + +@deftp {Data Type} scron-configuration +Data type representing the configuration of scron. + +@table @asis +@item @code{scron} (default: @var{scron}) +The scron package to use. + +@item @code{jobs} +This is a list of scron jobs. +@end table +@end deftp + +@deftp {Data Type} scron-job +Data type representing an scron job. + +@table @asis +@item @code{schedule} +The job schedule, in Vixie cron syntax. See the @code{scron(1)} +man page for more information. + +@item @code{command} +The shell command to run, as a value that lowers to a string. +@end table +@end deftp + + @node Log Rotation @subsection Log Rotation