Skip to content

Using the Broker Client API Example

The SDK provides a sample command line pre-session client called broker client example. This would enable you to call the included broker client libraries and establish a PCoIP connection. The Broker Client API example demonstrates the success path for establishing new PCoIP sessions.

Do not Use the Broker Client API Example in Production

The broker client is provided as an example only, and should not be used in production. The client does not have thorough error handling and does not validate or sanitize user input.

The sample broker client is located here:

usr/bin/

There are several files in this directory, but only two are relevant for the broker client example:

  • broker_client_example
  • login_info.txt

The broker_client_example executable is the sample command-line client; the login_info text file contains authentication information used by the client.

About login_info.txt

The Broker Client example uses a small local text file to supply session input values. The following is a sample login_info.txt file (one line):

my-machine.mydomain.com mydomain myuser "mypassword" desktop-resource

In the example above:

  • The FQDN of the host server is my-machine.mydomain.com
  • The domain is mydomain
  • The user is myuser
  • The password is mypassword
  • The host name is desktop-resource

Remote sessions established by broker_client_example are exactly the same as sessions established using the PCoIP Software Client, except that the input values are provided by login_info.txt instead of the client’s user interface.