0store-secure-add.1

   1 .TH 0STORE-SECURE-ADD 1 "2009" "Thomas Leonard" ""
   2 .SH NAME
   3 0store-secure-add \- add an implementation to the system cache
   4
   5 .SH SYNOPSIS
   6
   7 .B 0store-secure-add
   8 \fBDIGEST\fP
   9
  10 .SH DESCRIPTION
  11 .PP
  12 This command imports the current directory into the system-wide shared Zero
  13 Install cache (by default, as /var/cache/0install.net/implementations/DIGEST).
  14 This allows a program downloaded by one user to be shared with other users.
  15
  16 .PP
  17 The current directory must contain a file called '.manifest' listing all the
  18 files to be added (in the format required by DIGEST), and this file must have the
  19 given digest. If not, the import is refused. Therefore, it is only possible to
  20 add a directory to the cache if its name matches its contents.
  21
  22 .PP
  23 It is intended that it be safe to grant untrusted users permission to call
  24 this command with elevated privileges. To set this up, see below.
  25
  26 .SH SETTING UP SHARING
  27
  28 To enable sharing, the system administrator should follow these steps:
  29
  30 .PP
  31 Create a new system user to own the cache:
  32
  33 .B adduser --system zeroinst
  34
  35 .PP
  36 Create the shared directory, owned by this new user:
  37
  38 .B mkdir /var/cache/0install.net
  39
  40 .B chown zeroinst /var/cache/0install.net
  41
  42 .P
  43 Use visudo(8) to add these lines to /etc/sudoers:
  44
  45 .B Defaults>zeroinst env_reset
  46
  47 .B ALL     ALL=(zeroinst) NOPASSWD: /usr/bin/0store-secure-add
  48
  49 .P
  50 Create a script called
  51 .B 0store-secure-add-helper
  52 in PATH to call it. This script must be executable and contain these two lines:
  53
  54 .B
  55 #!/bin/sh
  56
  57 .B
  58 exec sudo -S -u zeroinst /usr/bin/0store-secure-add "$@" < /dev/null
  59
  60 .P
  61 The other Zero Install programs will call this helper script automatically.
  62
  63 .SH FILES
  64
  65 .IP "/var/cache/0install.net/implementations"
  66 Default system-wide Zero Install cache.
  67
  68 .IP "~/.config/0install.net/injector/implementation-dirs"
  69 List of system cache directories, one per line.
  70
  71 .SH LICENSE
  72 .PP
  73 Copyright (C) 2007 Thomas Leonard.
  74
  75 .PP
  76 You may redistribute copies of this program under the terms of the GNU Lesser General Public License.
  77
  78 .SH BUGS
  79 .PP
  80 This program is EXPERIMENTAL. It has not been audited. Do not use it yet in
  81 security-critial environments.
  82
  83 .PP
  84 The env_reset line in sudoers may not be required. sudo(1) seems to do it automatically.
  85
  86 .PP
  87 If sudo let us check whether we could call a command then we could switch to
  88 using it automatically, instead of needing to add the helper script. Currently,
  89 sudo delays for one second and writes to auth.log if we try to use this system
  90 when it hasn't been set up.
  91
  92 .PP
  93 Please report bugs to the developer mailing list:
  94
  95 http://0install.net/support.html
  96
  97 .SH AUTHOR
  98 .PP
  99 Zero Install was created by Thomas Leonard.
 100
 101 .SH SEE ALSO
 102 0store(1)
 103
 104 .PP
 105 The Zero Install web-site:
 106
 107 .B http://0install.net