0launch.1

   1 .TH 0LAUNCH 1 "2006" "Thomas Leonard" ""
   2 .SH NAME
   3 0launch \- download and run programs by URL
   4
   5 .SH SYNOPSIS
   6
   7 .B 0launch
   8 [\fBOPTION\fP]... \fBINTERFACE\fP [\fBARG\fP]...
   9
  10 .B 0launch
  11 --list [\fBSEARCH-TERM\fP]
  12
  13 .B 0launch
  14 --import [\fBINTERFACE-FILES\fP]
  15
  16 .SH DESCRIPTION
  17 .PP
  18 0launch runs a program, identified by an `INTERFACE'. If the program is not
  19 already on your computer, it downloads information about which versions are
  20 available, and lets you choose one to download. It will also (automatically)
  21 do the same for libraries the program needs.
  22
  23 .PP
  24 0launch will also check for updates if it has been a long time since the last
  25 check (configurable).
  26 0launch therefore allows users to download and upgrade software without
  27 needing root access.
  28
  29 .PP
  30 An INTERFACE can be either a URL in the form `http://site/program' or
  31 a local path name like `/path/to/program.xml'. For HTTP URLs, the remote
  32 file is a GPG-signed XML document. Local interface files are not signed.
  33
  34 .SH EXAMPLES
  35
  36 .PP
  37 When a program is available using 0launch, it will have an associated URL. To
  38 run the program, simply invoke 0launch with this as an argument:
  39
  40 .B 0launch http://rox.sourceforge.net/2005/interfaces/Edit
  41
  42 .PP
  43 The first time you do this, details about the program are downloaded and
  44 cached, and you will be prompted to confirm the versions to use. In future,
  45 the program will run directly from the cache without confirmation.
  46
  47 .PP
  48 To check for new versions:
  49
  50 .B 0launch --refresh http://rox.sourceforge.net/2005/interfaces/Edit
  51
  52 .PP
  53 To search the list of cached URLs:
  54
  55 .B 0launch --list Edit
  56
  57 .PP
  58 To avoid having to keep typing the full URI, use the 0alias(1) command
  59 to create shortcuts to run your programs.
  60
  61 .SH COMMAND-LINE OPTIONS
  62
  63 .TP
  64 \fB--before=VERSION\fP
  65 Choosen implementation's version number must be earlier than VERSION. i.e., force
  66 the use of an old version the program.
  67
  68 .TP
  69 \fB-c\fP, \fB--console\fP
  70 Never use the GUI. Normally, 0launch switches to graphical mode if it needs to
  71 download anything from the network (unless DISPLAY is not set).
  72
  73 .TP
  74 \fB-d\fP, \fB--download-only\fP
  75 Download any needed files, but stop before actually running the program.
  76
  77 .TP
  78 \fB-D\fP, \fB--dry-run\fP
  79 Just print what actions would be taken.
  80
  81 .TP
  82 \fB-f\fP, \fB--feed\fP
  83 Register (or unregister) an additional source of implementations. When you get
  84 a CVS version of a project, it may contain an interface XML file. To add this
  85 version to the list of available versions, use --feed on this XML file. The
  86 file is not copied, so you don't need to re-add the file each time it is
  87 updated.
  88
  89 Note that if you just want to run the program, you can invoke 0launch on the
  90 interface file directly (without using --feed). This will force the injector to
  91 use that version, but won't affect what happens when you run it using the URI
  92 as normal. Use --feed when you want to use the CVS version even when using the
  93 URI, or if the program is a library (and thus referenced by URI by other
  94 programs).
  95
  96 Note also that the stability of CVS versions may be set to 'developer', in
  97 which case you must set this as the preferred stability for the interface
  98 (using the GUI).
  99
 100 .TP
 101 \fB-g\fP, \fB--gui\fP
 102 Show the graphical policy editor. This allows you to select which version of
 103 a program or library to use.
 104
 105 .TP
 106 \fB-h\fP, \fB--help\fP
 107 Show the built-in help text.
 108
 109 .TP
 110 \fB-i\fP, \fB--import\fP
 111 Import from files, not from the network. This is useful when testing an
 112 interface file, to avoid uploading it to a remote server in order to download
 113 it again. It might also be useful when installing from a CD or similar.
 114 The file must have a trusted GPG digital signature, as when fetching from
 115 the network. For unsigned interfaces, see --feed.
 116
 117 .TP
 118 \fB-l\fP, \fB--list\fP
 119 List all known interface (program) URIs. If a search term is given, only
 120 URIs containing that string are shown (case insensitive).
 121
 122 .TP
 123 \fB-m\fP, \fB--main=MAIN\fP
 124 Run the specified executable instead of the default. If MAIN starts with '/'
 125 then the path is relative to the implementation's top-level directory,
 126 whereas otherwise it is relative to the directory containing the default
 127 MAIN program. For example, if the default MAIN is \fBbin/svn\fP then
 128 using \fB--main=svnadmin\fP will run \fB.../bin/svnadmin\fP instead.
 129
 130 .TP
 131 \fB--not-before=VERSION\fP
 132 Choosen implementation's version number must not be earlier than VERSION.
 133 E.g., if you want to run version 2.0 or later, use \fB--not-before=2.0\fP.
 134
 135 .TP
 136 \fB-o\fP, \fB--offline\fP
 137 Run in off-line mode, overriding the default setting. In off-line mode, no
 138 interfaces are refreshed even if they are out-of-date, and newer versions of
 139 programs won't be downloaded even if the injector already knows about them
 140 (e.g. from a previous refresh).
 141
 142 .TP
 143 \fB-r\fP, \fB--refresh\fP
 144 Fetch a fresh copy of all used interfaces. This will normally switch to GUI
 145 mode, unless --console is also given. Note that using --refresh and --gui
 146 together will check for updates to the GUI itself.
 147
 148 .TP
 149 \fB-s\fP, \fB--source\fP
 150 The implementation of the main (root) interface must have an architecture
 151 of the form '*-src' (normally a literal "*", but could be a compatible OS).
 152 Dependencies are normal implementations, not source ones.
 153
 154 .TP
 155 \fB-v\fP, \fB--verbose\fP
 156 More verbose output. Use twice for even more verbose output.
 157
 158 .TP
 159 \fB-V\fP, \fB--version\fP
 160 Display version information.
 161
 162 .SH FILES
 163
 164 Configuration files (see freedesktop.org basedir spec):
 165
 166 .IP "~/.config/0install.net/injector/global"
 167 Global configuration settings.
 168
 169 .IP "~/.config/0install.net/injector/trust"
 170 List of trusted keys.
 171
 172 .IP "~/.config/0install.net/injector/user_overrides"
 173 Per-interface settings, and extra feeds.
 174
 175 .PP
 176 Cached data (can be re-downloaded if lost):
 177
 178 .IP "~/.cache/0install.net/interfaces"
 179 Downloaded cached interface files.
 180
 181 .IP "~/.cache/0install.net/implementations"
 182 Downloaded cached implementations, indexed by manifest digest.
 183
 184 .PP
 185 See the 0store(1) man page for more information.
 186
 187 .SH LICENSE
 188 .PP
 189 Copyright (C) 2007 Thomas Leonard.
 190
 191 .PP
 192 You may redistribute copies of this program under the terms of the GNU General Public License.
 193 .SH BUGS
 194 .PP
 195 Please report bugs to the developer mailing list:
 196
 197 http://0install.net/support.html
 198
 199 .SH AUTHOR
 200 .PP
 201 The Zero Install Injector was created by Thomas Leonard.
 202
 203 .SH SEE ALSO
 204 0alias(1), 0store(1)
 205 .PP
 206 The Zero Install web-site:
 207
 208 .B http://0install.net