[146] | 1 | .Dd Wed Oct 22 2003 \" DATE
|
---|
| 2 | .Dt LAUNCH 1 LOCAL \" Program name and manual section number
|
---|
| 3 | .Os launch 1.0
|
---|
| 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 npswbmhCX \" [-npswbmhCX]
|
---|
| 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 \" [-a name]
|
---|
| 14 | .Op Ar item ... \" [item ...]
|
---|
| 15 | .Op Ar - \" [-]
|
---|
| 16 | .Nm
|
---|
| 17 | .Op Fl npflswbmhCX
|
---|
| 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 LaunchServices 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 | .El
|
---|
| 69 | .Pp
|
---|
| 70 | In addition to the above, you can specify applications, documents,
|
---|
| 71 | folders, disks and URLs as item arguments.
|
---|
| 72 | .Ss Action options
|
---|
| 73 | .Bl -tag -width -indent
|
---|
| 74 | .It Fl n
|
---|
| 75 | Print matching paths/URLs instead of opening them.
|
---|
| 76 | .It Fl p
|
---|
| 77 | Ask application(s) to print document(s).
|
---|
| 78 | .It Fl f
|
---|
| 79 | Display information about item(s).
|
---|
| 80 | .It Fl l
|
---|
| 81 | Launch URLs, treating "http://" URLs as Web sites instead of WebDAV
|
---|
| 82 | resources.
|
---|
| 83 | .El
|
---|
| 84 | .Ss Launch options
|
---|
| 85 | .Bl -tag -width -indent
|
---|
| 86 | .It Fl s
|
---|
| 87 | Launch target(s) as superuser, authenticating if needed.
|
---|
| 88 | .It Fl w
|
---|
| 89 | Wait for application to finish opening before exiting.
|
---|
| 90 | .It Fl b
|
---|
| 91 | Launch application in the background.
|
---|
| 92 | .It Fl m
|
---|
| 93 | Launch application again, even if already running.
|
---|
| 94 | .It Fl h
|
---|
| 95 | Hide application after it finishes opening.
|
---|
| 96 | .It Fl C
|
---|
| 97 | Force CFM/PEF Carbon application to open in Classic.
|
---|
| 98 | .It Fl X
|
---|
| 99 | Don't start the Classic environment for this Classic application if
|
---|
| 100 | Classic isn't running.
|
---|
| 101 | .El
|
---|
| 102 | .Sh SEE ALSO
|
---|
| 103 | .\" List links in ascending order by section, alphabetically within a section.
|
---|
| 104 | .\" Please do not reference files that do not exist without filing a bug report
|
---|
| 105 | .Xr appswitch 1 ,
|
---|
| 106 | .Xr GetFileInfo 1 ,
|
---|
| 107 | .Xr open 1
|
---|
| 108 | .Sh BUGS \" Document known, unremedied bugs
|
---|
| 109 | Launching may be very slow on Mac OS X 10.2.8 and earlier; this is an
|
---|
| 110 | acknowledged Mac OS X bug with no known workaround, and may affect
|
---|
| 111 | Apple's
|
---|
| 112 | .Xr open 1
|
---|
| 113 | command as well in certain cases. It is fixed in Mac OS X 10.3.
|
---|
| 114 | .Pp
|
---|
| 115 | The
|
---|
| 116 | .Fl m
|
---|
| 117 | option may not work well (or at all) before Mac OS X 10.3 because of
|
---|
| 118 | Mac OS X bugs.
|
---|
| 119 | .Pp
|
---|
| 120 | The
|
---|
| 121 | .Fl h
|
---|
| 122 | option requires the
|
---|
| 123 | .Fl b
|
---|
| 124 | option to be used as well, or Cocoa applications will not hide on
|
---|
| 125 | startup. This is a Mac OS X bug which is still unfixed as of Mac OS X
|
---|
| 126 | 10.3.
|
---|
| 127 | .Sh AUTHOR
|
---|
| 128 | .An "Nicholas Riley" Aq launchsw@sabi.net
|
---|
| 129 | .Pp
|
---|
| 130 | This page written in part by
|
---|
| 131 | .An "Hisashi T Fujinaka" Aq htodd@twofifty.com .
|
---|
| 132 | .\" .Sh HISTORY \" Document history if command behaves in a unique manner
|
---|