0launch(1)

10LAUNCH(1)                                                          0LAUNCH(1)
2
3
4

NAME

6       0launch — download and run programs by URL
7
8

SYNOPSIS

10       0launch [OPTION]... PROGRAM [ARG]...
11
12

DESCRIPTION

14       0launch  runs  the  given  program. PROGRAM is either a URL in the form
15       `http://site/program.xml' or a  local  path  name  like  `/path/to/pro‐
16       gram.xml'.
17
18
19       If  the  program  is  not  already  on your computer, 0launch downloads
20       information about which versions are available, and lets you choose one
21       to download. It will also (automatically) do the same for any libraries
22       the program needs.
23
24
25       Note that much of the functionality that was originally in 0launch  has
26       now moved to 0install(1).
27
28       0launch PROGRAM ARGS
29
30
31       is roughly equivalent to
32
33       0install run PROGRAM ARGS
34
35       See the 0install(1) man-page for more information.
36
37

EXAMPLES

39       When  a  program is available using 0launch, it will have an associated
40       URL. To run the program, simply invoke 0launch with this  as  an  argu‐
41       ment:
42
43       0launch http://rox.sourceforge.net/2005/interfaces/Edit
44
45
46       The  first  time  you do this, details about the program are downloaded
47       and cached, and you will be prompted to confirm the versions to use. In
48       future,  the program will run directly from the cache without confirma‐
49       tion.
50
51
52       To check for new versions:
53
54       0launch --refresh http://rox.sourceforge.net/2005/interfaces/Edit
55
56
57       To avoid having to keep typing the full URI,  use  the  `0install  add'
58       command to create shortcuts to run your programs.
59
60

COMMAND-LINE OPTIONS

62       0launch takes the same options as "0install run".
63
64

DEBUGGING TIPS

66       To  debug  0launch itself, use the --verbose and --console options. For
67       example:
68
69       $ 0launch -vvc http://myprog
70
71
72       To trace or debug programs run by 0launch, use  the  --wrapper  option.
73       For example, to run myprog --help, displaying all calls to open(2):
74
75       $ 0launch --wrapper="strace -e open" http://myprog --help
76
77       If your program is interpreted (e.g. a Python program), and you wish to
78       debug the interpreter running it, you can do it like this:
79
80       $ 0launch --wrapper="gdb --args python" http://myprog --help
81
82

FILES

84       Configuration files (see freedesktop.org basedir spec):
85
86
87       ~/.config/0install.net/injector/global
88              Global configuration settings.
89
90
91       ~/.config/0install.net/injector/trustdb.xml
92              List of trusted keys.
93
94
95       ~/.config/0install.net/injector/interfaces
96              Per-interface settings, and extra feeds.
97
98
99       Cached data (can be re-downloaded if lost):
100
101
102       ~/.cache/0install.net/interfaces
103              Downloaded cached feed files.
104
105
106       ~/.cache/0install.net/implementations
107              Downloaded cached implementations, indexed by manifest digest.
108
109
110       See the 0store(1) man page for more information.
111
112

LICENSE

114       Copyright (C) 2011 Thomas Leonard.
115
116
117       You may redistribute copies of this program under the terms of the  GNU
118       Lesser General Public License.
119

BUGS

121       Please report bugs to the developer mailing list:
122
123       http://0install.net/support.html
124
125

AUTHOR

127       Zero Install was created by Thomas Leonard.
128
129