| 1 | .Dd Mon Oct 30 2006 \" DATE
|
|---|
| 2 | .Dt LAUNCH 1 LOCAL \" Program name and manual section number
|
|---|
| 3 | .Os launch 1.1
|
|---|
| 4 | .Sh NAME
|
|---|
| 5 | .Nm launch
|
|---|
| 6 | .Nd find, open, print, or get information about files, folders, disks and URLs
|
|---|
| 7 | .Sh SYNOPSIS
|
|---|
| 8 | .Nm launch
|
|---|
| 9 | .Op Fl npswbmhCXLU \" [-npswbmhCXLU]
|
|---|
| 10 | .Op Fl c Ar creator \" [-c creator]
|
|---|
| 11 | .Op Fl i Ar bundleID \" [-i bundleID]
|
|---|
| 12 | .Op Fl u Ar URL \" [-u URL]
|
|---|
| 13 | .Op Fl a Ar name | Ar path \" [-a name|path]
|
|---|
| 14 | .Op Ar item ... \" [item ...]
|
|---|
| 15 | .Op Ar - \" [-]
|
|---|
| 16 | .Nm
|
|---|
| 17 | .Op Fl npflswbmhCXLU
|
|---|
| 18 | .Ar item ...
|
|---|
| 19 | .Sh DESCRIPTION
|
|---|
| 20 | The
|
|---|
| 21 | .Nm
|
|---|
| 22 | command is a replacement for Mac OS X's
|
|---|
| 23 | .Xr open 1
|
|---|
| 24 | command and opens a file (or a folder/directory or URL), as if you had
|
|---|
| 25 | double-clicked its icon in the Finder. If no application is specified,
|
|---|
| 26 | the default application determined by Launch Services is used to open
|
|---|
| 27 | items.
|
|---|
| 28 | .Pp
|
|---|
| 29 | .Nm
|
|---|
| 30 | invoked with a file or URL argument will open the URL directly or in
|
|---|
| 31 | your preferred helper application. Applications can be specified by
|
|---|
| 32 | their four-character creators (e.g. 'ToyS') or Java-style bundle ID
|
|---|
| 33 | (e.g. com.apple.scripteditor).
|
|---|
| 34 | .Pp
|
|---|
| 35 | .Nm
|
|---|
| 36 | can ask applications to print documents, a feature the OS X Finder is
|
|---|
| 37 | still missing. It can open applications in the background; can open
|
|---|
| 38 | multiple copies of applications; can open Carbon applications in
|
|---|
| 39 | Classic, or prevent Classic from starting; and can show information
|
|---|
| 40 | about any item on disk, including file type, creator, data and
|
|---|
| 41 | resource fork sizes, dates, and bundle ID.
|
|---|
| 42 | .Pp
|
|---|
| 43 | The options to
|
|---|
| 44 | .Nm
|
|---|
| 45 | are divided in three sections according to purpose. You can give
|
|---|
| 46 | .Nm
|
|---|
| 47 | a reference to an application in many ways, using the matching
|
|---|
| 48 | options. Once
|
|---|
| 49 | .Nm
|
|---|
| 50 | has identified one or more items, the action options indicate what to
|
|---|
| 51 | do with these items. Finally, if the action involves launching an
|
|---|
| 52 | application, the launch options allow further customization.
|
|---|
| 53 | .Ss Matching options
|
|---|
| 54 | .Bl -tag -width -indent
|
|---|
| 55 | .It Fl c Ar creator
|
|---|
| 56 | Match by creator (a four-character code, also known as a signature).
|
|---|
| 57 | .It Fl i Ar bundleID
|
|---|
| 58 | Match by bundle identifier, usually consisting of the reversed dot
|
|---|
| 59 | (.)-separated components of the application developer's Internet domain
|
|---|
| 60 | name, followed by the application name. For example, the Finder's
|
|---|
| 61 | bundle identifier is
|
|---|
| 62 | .Ar com.apple.Finder .
|
|---|
| 63 | Bundle identifiers are not case-sensitive.
|
|---|
| 64 | .It Fl u Ar URL
|
|---|
| 65 | Match application at
|
|---|
| 66 | .Ar URL
|
|---|
| 67 | (which must be a file:// URL).
|
|---|
| 68 | .It Fl a Ar name | Ar path
|
|---|
| 69 | Match application named
|
|---|
| 70 | .Ar name
|
|---|
| 71 | or at the path
|
|---|
| 72 | .Ar path .
|
|---|
| 73 | .El
|
|---|
| 74 | .Pp
|
|---|
| 75 | In addition to the above, you can specify applications, documents,
|
|---|
| 76 | folders, disks and URLs as item arguments.
|
|---|
| 77 | .Ss Action options
|
|---|
| 78 | .Bl -tag -width -indent
|
|---|
| 79 | .It Fl n
|
|---|
| 80 | Print matching paths/URLs instead of opening them.
|
|---|
| 81 | .It Fl p
|
|---|
| 82 | Ask application(s) to print document(s).
|
|---|
| 83 | .It Fl f
|
|---|
| 84 | Display information about item(s).
|
|---|
| 85 | .It Fl l
|
|---|
| 86 | Launch URLs, treating "http://" URLs as Web sites instead of WebDAV
|
|---|
| 87 | resources.
|
|---|
| 88 | .El
|
|---|
| 89 | .Ss Launch options
|
|---|
| 90 | .Bl -tag -width -indent
|
|---|
| 91 | .It Fl s
|
|---|
| 92 | Launch target(s) as superuser, authenticating if needed.
|
|---|
| 93 | .It Fl w
|
|---|
| 94 | Wait for application to finish opening before exiting.
|
|---|
| 95 | .It Fl b
|
|---|
| 96 | Launch application in the background.
|
|---|
| 97 | .It Fl m
|
|---|
| 98 | Launch application again, even if already running.
|
|---|
| 99 | .It Fl h
|
|---|
| 100 | Hide application after it finishes opening.
|
|---|
| 101 | .It Fl C
|
|---|
| 102 | Force CFM/PEF Carbon application to open in Classic.
|
|---|
| 103 | .It Fl X
|
|---|
| 104 | Don't start the Classic environment for this Classic application if
|
|---|
| 105 | Classic isn't running.
|
|---|
| 106 | .It Fl L
|
|---|
| 107 | Suppress the normal opening behavior of the application; for example,
|
|---|
| 108 | opening an untitled document. (This works by sending a "launch", or
|
|---|
| 109 | ascr/noop, Apple event to the application.)
|
|---|
| 110 | .It Fl U
|
|---|
| 111 | Interpret items as URLs, even if files with the same names as the URLs
|
|---|
| 112 | exist. (This was the default behavior in
|
|---|
| 113 | .Nm
|
|---|
| 114 | 1.0.)
|
|---|
| 115 | .El
|
|---|
| 116 | .Sh SEE ALSO
|
|---|
| 117 | .\" List links in ascending order by section, alphabetically within a section.
|
|---|
| 118 | .\" Please do not reference files that do not exist without filing a bug report
|
|---|
| 119 | .Xr appswitch 1 ,
|
|---|
| 120 | .Xr GetFileInfo 1 ,
|
|---|
| 121 | .Xr open 1
|
|---|
| 122 | .Sh BUGS \" Document known, unremedied bugs
|
|---|
| 123 | The
|
|---|
| 124 | .Fl h
|
|---|
| 125 | option requires the
|
|---|
| 126 | .Fl b
|
|---|
| 127 | option to be used as well, or Cocoa applications will not hide on
|
|---|
| 128 | startup. This is a Mac OS X bug which is still unfixed as of Mac OS X
|
|---|
| 129 | 10.4.8.
|
|---|
| 130 | .Sh AUTHOR
|
|---|
| 131 | .An "Nicholas Riley" Aq launchsw@sabi.net
|
|---|
| 132 | .Pp
|
|---|
| 133 | Original man page written by
|
|---|
| 134 | .An "Hisashi T Fujinaka" Aq htodd@twofifty.com .
|
|---|
| 135 | .\" .Sh HISTORY \" Document history if command behaves in a unique manner
|
|---|
