Command Line Options pcopip_agent

The pcoip_agent command supports the following command line options:


The daemon included with release 4.5.0 and later starts the UI. Do not start the host 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:
    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:
  • 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 host 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 host software code that checks if TwinView is enabled and disable TwinView, include the -dtoption.


    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 host software.

  • Host 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 host software.

  • When the remote cursor synchronization feature is enabled, the host 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 host software to send reports every 10 ms.


    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 Host Software Configuration Files for details on using these options.