home: services: Add log rotation service.

* gnu/home/services/admin.scm: New file.
* gnu/local.mk (GNU_SYSTEM_MODULES): Add it.
* doc/guix.texi (Shepherd Home Service): Document it.

Change-Id: I37ac171147c236b05d6d3b226e9072ab7524dfe9

1 files changed, 15 insertions, 0 deletions

diff --git a/doc/guix.texi b/doc/guix.texi
index 66faaee1dc..01a2ca19d0 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -20910,6 +20910,7 @@ This is the type of the log rotation service.  Its associated value must
 be a @code{log-rotation-configuration} record, as discussed below.
 @end defvar
 
+@anchor{log-rotation-configuration}
 @c %start of fragment
 
 @deftp {Data Type} log-rotation-configuration
@@ -47296,6 +47297,20 @@ mechanism instead (@pxref{Shepherd Services}).
 @end table
 @end deftp
 
+@cindex log rotation, for user services
+The Shepherd also comes with a @dfn{log rotation service}, which
+compresses and then deletes old log files produced by services and
+daemons that it runs.  This service is made available through
+@code{home-log-rotation-service-type} as described below.
+
+@defvar home-log-rotation-service-type
+This is the service type for the user Shepherd log rotation service
+(@pxref{Log Rotation Service,,, shepherd, The GNU Shepherd Manual}).
+Its value must be a @code{log-rotation-configuration} record, exactly as
+for its system-wide counterpart.  @xref{log-rotation-configuration}, for
+its reference.
+@end defvar
+
 @node Secure Shell
 @subsection Secure Shell