| dkegel@google.com | f20da1f | 2009-06-30 19:16:32 +0000 | [diff] [blame] | 1 | .\" ** You probably do not want to edit this file directly ** |
| 2 | .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). |
| 3 | .\" Instead of manually editing it, you probably should edit the DocBook XML |
| 4 | .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. |
| 5 | .TH "XDG\-OPEN" "1" "06/24/2007" "xdg\-utils 1.0" "" |
| 6 | .\" disable hyphenation |
| 7 | .nh |
| 8 | .\" disable justification (adjust text to left margin only) |
| 9 | .ad l |
| 10 | .SH "NAME" |
| 11 | xdg\-open \- opens a file or URL in the user's preferred application |
| 12 | .SH "SYNOPSIS" |
| 13 | .HP 9 |
| 14 | \fBxdg\-open\fR {\fB\fIfile\fR\fR \fB\fIURL\fR\fR} |
| 15 | .HP 9 |
| 16 | \fBxdg\-open\fR {\fB\-\-help\fR \fB\-\-manual\fR \fB\-\-version\fR} |
| 17 | .SH "DESCRIPTION" |
| 18 | .PP |
| 19 | xdg\-open opens a file or URL in the user's preferred application. If a URL is provided the URL will be opened in the user's preferred web browser. If a file is provided the file will be opened in the preferred application for files of that type. xdg\-open supports file, ftp, http and https URLs. |
| 20 | .PP |
| 21 | xdg\-open is for use inside a desktop session only. It is not recommended to use xdg\-open as root. |
| 22 | .SH "OPTIONS" |
| 23 | .TP |
| 24 | \fB\-\-help\fR |
| 25 | Show command synopsis. |
| 26 | .TP |
| 27 | \fB\-\-manual\fR |
| 28 | Show this manualpage. |
| 29 | .TP |
| 30 | \fB\-\-version\fR |
| 31 | Show the xdg\-utils version information. |
| 32 | .SH "EXIT CODES" |
| 33 | .PP |
| 34 | An exit code of 0 indicates success while a non\-zero exit code indicates failure. The following failure codes can be returned: |
| 35 | .TP |
| 36 | \fB1\fR |
| 37 | Error in command line syntax. |
| 38 | .TP |
| 39 | \fB2\fR |
| 40 | One of the files passed on the command line did not exist. |
| 41 | .TP |
| 42 | \fB3\fR |
| 43 | A required tool could not be found. |
| 44 | .TP |
| 45 | \fB4\fR |
| 46 | The action failed. |
| 47 | .SH "EXAMPLES" |
| 48 | .PP |
| 49 | .nf |
| 50 | xdg\-open 'http://www.freedesktop.org/' |
| 51 | .fi |
| 52 | .sp |
| 53 | Opens the Freedesktop.org website in the user's default browser |
| 54 | .PP |
| 55 | .nf |
| 56 | xdg\-open /tmp/foobar.png |
| 57 | .fi |
| 58 | .sp |
| 59 | Opens the PNG image file /tmp/foobar.png in the user's default image viewing application. |
| mdm@chromium.org | 56df6d3 | 2010-08-31 18:16:49 +0000 | [diff] [blame^] | 60 | .SH "FILES" |
| 61 | .PP |
| 62 | \fI/usr/share/applications/defaults.list ~/.local/share/applications\fR |
| 63 | .SH "SEE ALSO" |
| 64 | .PP |
| 65 | \fBxdg-mime\fR(1), |
| dkegel@google.com | f20da1f | 2009-06-30 19:16:32 +0000 | [diff] [blame] | 66 | .SH "AUTHOR" |
| 67 | Kevin Krammer, Jeremy White. |
| 68 | .br |
| 69 | <kevin.krammer@gmx.at> |
| 70 | .br |
| 71 | <jwhite@codeweavers.com> |