Command Line Options pcoip_agent

The pcoip_agent command supports the following command line options:

Note

The daemon included with release 4.5.0 and later starts the UI. Do not start the Remote Workstation Card Software manually. In some situations a user might invoke the pcoip_agent command from the command line to disconnect a session or query information about the host card.

  • To list all supported command line options, enter pcoip_agent –h.

  • To disconnect a session, enter pcoip_agent –disconnect. This method is useful for making a disconnect-session shortcut, or mapping to a favorite key on some keyboards.

  • The UI IT auditing feature writes information about the workstation and PCoIP host card to the command line. To invoke this feature, enter pcoip_agent -info. This is an example of the output:

    Host Name: localhost.localdomain
    Host IP: 192.168.0.13
    Host MAC: 00-2b-68-33-11-28
    PCoIP Host SW Version: 3.0.2
    PCoIP Host SW Build Date: Apr 18 2012 17:04:42
    PCoIP Host card MAC: 00-30-04-0D-61-26
    PCoIP Host card IP: 192.168.99.21
    
  • The -ll option is used to set the logging level of the UI. The supported logging levels are 0=none (default), 1=critical, 2=error, 3=info and 4=debug. To set the logging level to debug enter the following command:

    pcoip_agent –ll=4

  • TwinView is a video mode supported by Nvidia graphics cards on multi-monitor workstations. The Remote Workstation Card Software checks if this mode is enabled using the nvidia-settings utility. If TwinView is enabled on a workstation and the nvidia-settings utility is not installed or the utility does not support querying the TwinView option, users must include the -t option when starting the pcoip_agent executable. To override the Remote Workstation Card Software code that checks if TwinView is enabled and disable TwinView, include the -dtoption.

    Note

    Some multi-monitor workstations using newer versions of the Nvidia driver with Xinerama enabled must include the -t option when starting the pcoip_agent. If the remote and local cursors are not in sync, add the -t option to the HostSWOptions setting in the daemon configuration file and restart the Remote Workstation Card Software.

  • Remote Workstation Card Software release 4.0.3 and later include support for the remote cursor synchronization feature which periodically compares the position of the remote and local cursors. The local cursor position is updated when the remote cursor is moved by something other than the local cursor, which may be an application running on the host or a bridged USB tablet. To disable this feature, include the -drcs option to the HostSWOptions setting in the daemon configuration file and restart the Remote Workstation Card Software.

  • When the remote cursor synchronization feature is enabled, the Remote Workstation Card Software sends updates to the client every 250 ms when the host cursor moves. The period of these reports can be changed by specifying the -rcsp=10 option, which configures the Remote Workstation Card Software to send reports every 10 ms.

    Note

    Zero client users that set Visible Cursor(s) to Local and bridge USB devices that change the position of the cursor should use this setting to reduce the time between updates from 250 ms to 10 ms to avoid choppy cursor movement.

  • The command line options -gc= and lc= can be used to specify a global configuration file and local configuration file. See Remote Workstation Card Software Configuration Files for details on using these options.