[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH] services: Add transmission-service.
From: |
David Thompson |
Subject: |
[PATCH] services: Add transmission-service. |
Date: |
Fri, 27 Nov 2015 20:46:25 -0500 |
User-agent: |
Notmuch/0.20.2 (http://notmuchmail.org) Emacs/24.5.1 (x86_64-unknown-linux-gnu) |
My first service since the big service API rewrite. How did I do?
>From 6f483d37bf157ee0d253d2aaa919d6900d23453c Mon Sep 17 00:00:00 2001
From: David Thompson <address@hidden>
Date: Fri, 27 Nov 2015 20:40:59 -0500
Subject: [PATCH] services: Add transmission-service.
* gnu/services/bittorrent.scm: New file.
* gnu-system.am (GNU_SYSTEM_MODULES): Add it.
* doc/guix.texi ("BitTorrent Services"): Document it.
---
doc/guix.texi | 19 +++++++
gnu-system.am | 1 +
gnu/services/bittorrent.scm | 122 ++++++++++++++++++++++++++++++++++++++++++++
3 files changed, 142 insertions(+)
create mode 100644 gnu/services/bittorrent.scm
diff --git a/doc/guix.texi b/doc/guix.texi
index b404453..847d196 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -6292,6 +6292,7 @@ declaration.
* Desktop Services:: D-Bus and desktop services.
* Database Services:: SQL databases.
* Web Services:: Web servers.
+* BitTorrent Services:: BitTorrent services.
* Various Services:: Other services.
@end menu
@@ -7013,6 +7014,24 @@ directories are created when the service is activated.
@end deffn
address@hidden BitTorrent Services
address@hidden BitTorrent Services
+
+The @code{(gnu services bittorrent)} module provides the following service:
+
address@hidden {Scheme Procedure} transmission-service [#:transmission
transmission] @
+ [#:port 9091] [#:peer-port 51413]@
+ [#:download-directory ``/var/lib/transmission/downloads'']
+
+Return a service that runs @var{transmission}, a daemon that downloads
+and shares files via the BitTorrent protocol.
+
+The daemon will serve the web user interface over @var{port}, handle
+BitTorrent tasks over @var{peer-port}, and save downloaded files to
address@hidden
+
address@hidden deffn
+
@node Various Services
@subsubsection Various Services
diff --git a/gnu-system.am b/gnu-system.am
index f69645b..da1b359 100644
--- a/gnu-system.am
+++ b/gnu-system.am
@@ -354,6 +354,7 @@ GNU_SYSTEM_MODULES = \
gnu/services.scm \
gnu/services/avahi.scm \
gnu/services/base.scm \
+ gnu/services/bittorrent.scm \
gnu/services/databases.scm \
gnu/services/dbus.scm \
gnu/services/desktop.scm \
diff --git a/gnu/services/bittorrent.scm b/gnu/services/bittorrent.scm
new file mode 100644
index 0000000..140df53
--- /dev/null
+++ b/gnu/services/bittorrent.scm
@@ -0,0 +1,122 @@
+;;; GNU Guix --- Functional package management for GNU
+;;; Copyright © 2015 David Thompson <address@hidden>
+;;;
+;;; This file is part of GNU Guix.
+;;;
+;;; GNU Guix is free software; you can redistribute it and/or modify it
+;;; under the terms of the GNU General Public License as published by
+;;; the Free Software Foundation; either version 3 of the License, or (at
+;;; your option) any later version.
+;;;
+;;; GNU Guix is distributed in the hope that it will be useful, but
+;;; WITHOUT ANY WARRANTY; without even the implied warranty of
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;;; GNU General Public License for more details.
+;;;
+;;; You should have received a copy of the GNU General Public License
+;;; along with GNU Guix. If not, see <http://www.gnu.org/licenses/>.
+
+(define-module (gnu services bittorrent)
+ #:use-module (gnu services)
+ #:use-module (gnu services dmd)
+ #:use-module (gnu system shadow)
+ #:use-module (gnu packages admin)
+ #:use-module (gnu packages bittorrent)
+ #:use-module (guix records)
+ #:use-module (guix gexp)
+ #:use-module (ice-9 match)
+ #:export (%transmission-state-directory
+
+ transmission-configuration
+ transmission-configuration?
+ transmission-configuration-transmission
+ transmission-configuration-port
+ transmission-configuration-peer-port
+ transmission-configuration-download-directory
+
+ transmission-service-type
+ transmission-service))
+
+;;; Commentary:
+;;;
+;;; BitTorrent services.
+;;;
+;;; Code:
+
+(define %transmission-state-directory "/var/lib/transmission")
+
+(define-record-type* <transmission-configuration>
+ transmission-configuration make-transmission-configuration
+ transmission-configuration?
+ (transmission transmission-configuration-transmission) ; <package>
+ (port transmission-configuration-port) ; integer
+ (peer-port transmission-configuration-peer-port) ; integer
+ (download-directory transmission-configuration-download-directory)) ; string
+
+(define %transmission-accounts
+ (list (user-group (name "transmission") (system? #t))
+ (user-account
+ (name "transmission")
+ (group "transmission")
+ (system? #t)
+ (comment "transmission daemon user")
+ (home-directory "/var/empty")
+ (shell #~(string-append #$shadow "/sbin/nologin")))))
+
+(define (transmission-activation config)
+ (let ((download-dir (transmission-configuration-download-directory config)))
+ #~(begin
+ (use-modules (guix build utils))
+
+ (display "creating transmission state directory\n")
+ (mkdir-p #$%transmission-state-directory)
+ (format #t "creating transmission download directory '~a'~%"
+ #$download-dir)
+ (mkdir-p #$download-dir))))
+
+(define transmission-dmd-service
+ (match-lambda
+ (($ <transmission-configuration> transmission port peer-port download-dir)
+ (let* ((daemon #~(string-append #$transmission
"/bin/transmission-daemon"))
+ (start-action
+ #~(make-forkexec-constructor
+ (list #$daemon "--foreground"
+ (string-append "--port=" (number->string #$port))
+ (string-append "--peerport="
+ (number->string #$peer-port))
+ (string-append "--download-dir=" #$download-dir)
+ (string-append "--config-dir="
+ #$%transmission-state-directory)))))
+ (list (dmd-service
+ (provision '(transmission))
+ (documentation "Run the transmission daemon.")
+ (requirement '(user-processes loopback))
+ (start start-action)
+ (stop #~(make-kill-destructor))))))))
+
+(define transmission-service-type
+ (service-type (name 'transmission)
+ (extensions
+ (list (service-extension dmd-root-service-type
+ transmission-dmd-service)
+ (service-extension activation-service-type
+ transmission-activation)
+ (service-extension account-service-type
+ (const %transmission-accounts))))))
+
+(define* (transmission-service #:key (transmission transmission)
+ (port 9091) (peer-port 51413)
+ (download-directory
+ (string-append %transmission-state-directory
+ "/downloads")))
+ "Return a service that runs TRANSMISSION, a daemon that downloads and shares
+files via the BitTorrent protocol.
+
+The daemon will serve the web user interface over PORT, handle BitTorrent
+tasks over PEER-PORT, and save downloaded files to DOWNLOAD-DIRECTORY."
+ (service transmission-service-type
+ (transmission-configuration
+ (transmission transmission)
+ (port port)
+ (peer-port peer-port)
+ (download-directory download-directory))))
--
2.5.0
--
David Thompson
GPG Key: 0FF1D807
- [PATCH] services: Add transmission-service.,
David Thompson <=