4.2. Supported Command Options

The available options for the ovdc command are shown in Table 4.1, “Command Options”.

Table 4.1. Command Options

Command Option

Description

-?

--help

Display help for the command.

-c

--create-profile

Create a new profile from the command line, without running Oracle Virtual Desktop Client or displaying the connect screen.

Profile settings are saved to the profile file specified by the --profile option, or to the default profile if no --profile option is supplied. See Section 5.5, “Creating New Profiles From the Command Line” .

-v

--version

Display version information.

--autoconnect

Use a discovery mechanism, such as DHCP, to select a server on your network automatically. The connect screen is not displayed.

-f

--fullscreen

Display the desktop session using the whole screen area.

--windowed

Display the desktop session in a window on screen.

--size widthxheight

Dimensions of the desktop session, in pixels.

width is the width of the desktop session, between 64 and 5120 pixels.

height is the height of the desktop session, between 64 and 5120 pixels.

--audio

Enable audio output on the client computer.

-n

--noaudio

Disable audio output on the client computer.

-i

--clientid

Display the client ID for Oracle Virtual Desktop Client.

-b megabits

--bandwidth megabits

Maximum bandwidth for the connection, in megabits per second.

-p

--span

Multiple monitors only. Span the display across all screens.

--nospan

Multiple monitors only. Show the display on a single monitor.

-r num

--onscreen num

Multiple monitors only. Use the specified screen to display the session.

-a

--autosize

Automatically size the desktop session for the client computer.

--noautosize

Do not automatically size the desktop session for the client computer.

-m bytes

--mtu bytes

Maximum Transmission Unit (MTU). The maximum packet size for connections.

-M

--mtu-auto-detect

Enable automatic detection of MTU for connections.

--no-mtu-auto-detect

Disable automatic detection of MTU for connections.

--profile profilename

Run Oracle Virtual Desktop Client using the settings defined in the specified profile file. For profile files that are not in the default location, enter the full path name to the file.

If the --profile option is not used, the default profile is used for the session.

If the profilename file does not exist, it is created automatically on connection and contains the values from the Settings tabs.

Note

The settings in the profile can be overridden by other command line options. See Section 5.4, “Overriding Profile Settings” .

-o

--force-compression

Automatically compress all packets before transmission.

--noforce-compression

Do not automatically compress all packets before transmission.

-e

--lossless-compression

Use only lossless compression for image data. Disable lossy compression.

--nolossless-compression

Use lossy or lossless compression for image data.

-l num

--logging-level num

Level of log messages to record.

0 = No logging. This is the default setting.

1 = Critical messages

2 = Warnings

3 = Informational messages

Logging level is cumulative. For example, selecting log level 3 includes all warnings and critical messages.

-d num

--logging-domains num

Categories of log messages to record.

1 = Session

2 = Network

4 = Input

8 = Appliance Link Protocol (ALP) commands

16 = Multimedia

32 = Audio

64 = Display

128 = Smart card

256 = Serial

1024 = Channel

For multiple categories, add the values.

For example, 33 = Audio + Session, 2047 = All categories.

-N num

--network num

Protocol used for network connections.

0 = Auto

1 = IPv4

2 = IPv6

-h num

--hostkey num

Host key, used in keyboard shortcuts for Oracle Virtual Desktop Client.

-1 = Disabled

0 = Left Shift

1 = Right Shift

2 = Left Control

3 = Right Control

-R

--audiorec

Enable audio input from the client computer.

-C

--noaudiorec

Disable audio input from the client computer.

--logfile

Name of the log file. If you do not enter a full path name, the log file is stored in the default location.

--serial

Enable support for the serial port on the client computer.

--noserial

Disable support for the serial port on the client computer.

--smartcard

Enable support for using a smart card on the client computer.

--nosmartcard

Disable support for using a smart card on the client computer.

-k num

--keyboard-country-code num

Country code for the keyboard on the client computer. Oracle Virtual Desktop Client automatically detects the keyboard country code from the operating system on the client computer. Specify a value from 0 to 255 if you want to override this.

--S

--savesecure

Enable secure profile entries. Security-sensitive profile entries, such as the client key fingerprint, are not shown in the profile file.

--nosavesecure

Disable secure profile entries.

--P

--clipboard

Enable clipboard sharing. Allows you to copy and paste between an application running in the remote session and the client computer.

To use copy and paste, the clipboard service must be running on the remote server.

--noclipboard

Disable clipboard sharing.


4.2.1. Command Line Examples

The following examples show how you can configure and run Oracle Virtual Desktop Client from the command line.

To start Oracle Virtual Desktop Client and display the connect screen:

ovdc

To connect to a server on your network automatically, without displaying the connect screen:

ovdc --autoconnect

To display a full screen session from the server sr-1.example.com:

ovdc --fullscreen sr-1.example.com

To connect using an MTU of 1366 bytes:

ovdc --mtu 1366 sr-1.example.com

To run Oracle Virtual Desktop Client using the settings defined in the fullscreenmode profile:

ovdc --profile fullscreenmode sr-1.example.com