Netscape Communicator for Solaris is comprised of a comprehensive set of components that integrates browsing, email, web-based word processing, chat, and group scheduling to allow users to easily communicate, share, and access information.

Any argument that is not a switch is interpreted as either a file or URL. The following options are supported:

-component-bar

Shows only the Component Bar.

-composer

Opens all command line URLs in Composer.

-discussions

Shows Collabra Discussions.

-display dpy

Specifies the X server to use for display.

-dont-force-window-stacking

Ignores the alwaysraised, alwayslowered, and z-lock JavaScript window.open() attributes.

-dont-save-geometry-prefs

Does not save window geometry preferences for the session.

-edit

See -composer.

-geometry =WxH+X+Y

Positions and sizes the Netscape window.

-help

Shows the command line options for Netscape.

-iconic

Minimizes Netscape after start up.

-id window-id

Identifies an X window to receive -remote commands. If you do not specify a window, the first window found is used.

-ignore-geometry-prefs

Ignores saved window geometry preferences for the current session.

-install

Installs private colormap.

-irix-session-management

Enables IRIX session management. On SGI systems, IRIX session management is enabled by default. IRIX session management is available on other platforms and may work with session managers other than the IRIX desktop. See -no-irix-session-management.

-mail

Same as -messenger.

-messenger

Shows the Messenger Mailbox (Inbox).

-mono

Forces a one-bit deep image display.

-ncols N

Sets the maximum number of colors to allocate for images when not using -install.

-nethelp

Starts NetHelp, Netscape's online help system.

-news

Same as -discussions.

-no-about-splash

Bypasses the startup license page.

-no-install

Uses the default colormap.

-no-irix-session-management

Disables IRIX session management. See -irix-session-management.

-no-session-management

Disables session management. Session management is enabled by default. See -session-management.

-noraise

Does not display the remote window on top when using -remote commands. See -raise and -remote.

-raise

Displays the remote window on top when using -remote commands. See -noraise and -remote.

-remote remote-command

Connects to and controls an existing process. You can issue multiple -remote options on the same command line. The commands are executed sequentially unless a command fails. If there is no Netscape process currently running, this command fails. If the command fails, an error message will be reported to stderr and it will exit with a nonzero status. See REMOTE ACTIONS section below and EXAMPLES.

The following options exist for finer-grained control of the -remote commands:

-id X_window_ID

If there is more than one Netscape Navigator window open, this option selects the window to control. If you do not use this option, the first window found is controlled. See EXAMPLES.

-raise

-noraise

Controls whether the -remote command causes the Netscape window to raise/not raise itself to the top. The default is raise.

You can use -raise and -noraise options with the addBookmark and openURL arguments. See EXAMPLES.

-session-management

Enables session management. Session management is enabled by default. See -no-session-management.

-version

Displays the version number and build date.

-visual id-or-number

Uses the specified server visual.

-xrm resource-spec

Sets the specified X resource.

When Netscape Navigator is invoked with the -remote argument, it does not open a window, but instead connects to and controls an already existing process. The argument to the -remote switch is an Xt action to invoke, with optional arguments. Remote control is implemented using X properties, so the two processes need not be running on the same machine, and need not share a file system. See http://home.netscape.com/newsref/std/x-remote.html.

All of Netscape's action names are the same as its resource names. For example, if you wanted to know the name of the action that corresponds to the ``Add Bookmark'' menu item, you could look in Netscape for ``Add Bookmark'' and see that the resource that is set to that string is addBookmark. That is the name of the Action as well. Note: To find the Netscape file, use the full path name which is, by default, /usr/dt/appconfig/netscape/lib/locale/C/app-defaults/Netscape.

You can use Actions in Translation tables in the usual Xt manner, but you can also invoke them directly via the -remote option, like this:

netscape -remote 'addBookmark()'

That command will cause the existing Netscape Navigator process to add its current URL to the bookmarks, just as if you had selected that menu item.

To open a document, enter:

netscape -remote 'openURL(http://home.netscape.com)'

Invoking an action with no arguments has the same effect as selecting the corresponding menu item. However, with some actions you can pass the following arguments:

addBookmark( )

Adds the current document to the Bookmark list.

addBookmark(URL)

Adds the specified document to the Bookmark list. See EXAMPLES.

addBookmark(URL, title)

Adds the specified document and title to the Bookmark list.

mailto( )

Opens the mail dialog box with an empty To: field.

mailto(a, b. c)

Inserts the specified address(es) in the default To: field.

openFile( )

Opens a dialog box that prompts for a file.

openFile(filename)

Opens the specified file.

openURL( )

Opens a dialog box that prompts for a URL.

openURL(URL)

Opens the specified document. See EXAMPLES.

openURL(URL, new window)

Opens a new window displaying the specified document.

saveAs( )

Opens a dialog box that prompts for a URL.

saveAs(output_file)

Writes HTML to the specified file.

saveAs(output_file, type)

Writes the type to the specified file (HTML, text, or PostScript).

If a command fails, an error message is reported to stderr and the command exits with a nonzero status.

The following are all examples of using the -remote command option. For more information and examples, see http://home.netscape.com/newsref/std/x-remote.html

example% netscape -id 0x3c00124 -remote 'openURL(http://www.sun.com)'

example% netscape -remote 'addBookmark(http://www.sun.com)'

example% netscape -remote 'openURL(http://www.sun.com)'

See attributes(5) for descriptions of the following attributes:

attributes(5)

Refer to the Netscape Communicator online help for more information.