diff options
| -rw-r--r-- | README | 126 |
1 files changed, 1 insertions, 125 deletions
@@ -1,125 +1 @@ -* An -*- outline -*- of the GNU Daemon Shepherd. - -** What is the Shepherd? - -The GNU Daemon Shepherd or GNU Shepherd is a service manager written in -Guile that looks after the herd of system services, providing a -replacement for the service-managing capabilities of SysV-init (or any -other init) with a dependency-based system with a convenient interface. -It is intended for use on GNU/Linux and GNU/Hurd, but it is supposed to work -on every POSIX-like system where Guile is available. - -In a previous life, the GNU Shepherd was known as GNU dmd, the -daemon-managing daemon. - -** Requirements - -The GNU Shepherd depends on the following pieces of software: - - - GNU Guile 3.0.x, https://gnu.org/software/guile - - Fibers 1.1.0 or later, https://github.com/wingo/fibers - -** Getting started - -Like all GNU packages, this program can be installed using familiar -incantations such as: - - autoreconf -vfi - ./configure --prefix=/some/where - make - make check - make install - -Actually setting up the Shepherd currently requires some work. You -should read the Texinfo manual for details: - - info -f shepherd.info - -** Installing development snapshots with Guix - -The Shepherd repository can be used as a Guix “channel”. To do that, change -~/.config/guix/channels.scm along these lines: - - (append (list (channel - (name 'shepherd) - (url "https://codeberg.org/shepherd/shepherd.git") - (branch "main") - (introduction - (make-channel-introduction - "788a6d6f1d5c170db68aa4bbfb77024fdc468ed3" - (openpgp-fingerprint - "3CE464558A84FDC69DB40CFB090B11993D9AEBB5"))))) - %default-channels) - -Once that is done, run ‘guix pull’. This will give you additional ‘shepherd’ -packages with higher version numbers: - - guix package -A shepherd - -You can then install it with ‘guix install shepherd’, or e.g. use it in an -operating-system configuration: - - (operating-system - ... - (essential-services - (modify-services (operating-system-default-essential-services - this-operating-system) - (shepherd-root-service-type - config => - (shepherd-configuration - (inherit config) - (shepherd (@ (shepherd-package) shepherd))))))) - -** More information - -Detailed instructions on installing the GNU Shepherd are available in -the file `INSTALL'. A list of user-visible changes between releases can -be found in the file `NEWS'. - -See the Git version control history for a list of people who contributed to -this software in the form of changes to the code: - - https://codeberg.org/shepherd/shepherd/commits/branch/main - -This program can be distributed under the terms of the GNU General -Public License, version 3 or any later version, see the file `COPYING' -for details. The Texinfo manual can be distributed under the terms of -the GNU Free Documentation License, version 1.3 or any later version, -see the manual for details. Note that for any copyright year range -specified as YYYY-ZZZZ in this package, the range specifies every single -year in that closed interval. - - -The GNU Shepherd home page is at: - - http://www.gnu.org/software/shepherd/ - -The GNU Shepherd is developed jointly with the GNU Guix project. Both -are essential components in putting the pieces together to build the GNU -system. Join us now! - -** Hacking - -Using GNU Guix, you can enter a development environment by running: - - guix shell -D -f guix.scm - -or simply: - - guix shell - -The first time you obtain a copy of the repository, authenticate it by -running: - - guix git authenticate \ - 788a6d6f1d5c170db68aa4bbfb77024fdc468ed3 \ - 3CE464558A84FDC69DB40CFB090B11993D9AEBB5 - -The command exits with zero on success, and errors out otherwise. It installs -Git hooks such as subsequent invocations of ‘git pull’ and ‘git push’ will -automatically authenticate it. - -** Reporting bugs - -Send bug reports to <[email protected]>, with "Shepherd" and the version -number in the Subject line. +This repository has moved to https://codeberg.org/shepherd/shepherd, see you there! |