a) Open GPUPerfClient.exe
b) Start The Connection Process
- File->Connnect or Click on the computer icon on the toolbar (tooltip says "Connect")
- This will bring up a window with advice on the best way to start your application (see image below)
- Follow the startup advice and allow your application to fully start before connecting the client.
- If the client detects that a server is already running on the same machine, the client will automatically connect to it. The server must already be attached to your application.
- If there is no server already running on the local machine, the Server Connection Dialog will open.
c) Server Connection Dialog
- "Server Host"
- Use "localhost" when connecting locally if you'd like the server to be auto-launched.
- You can either type in the hostname or IP address of the target computer, or select from the drop-down list of the 10 most recently used computers.
- "Port"
- This will be the port that the client and server will communicate over.
- If the server is already running, this must match the port that the server is listening on.
- If another application is already listening on this port, a different port must be used, or the other application must be closed.
- "Application"
- Stores the 10 most recently used applications for the selected target computer.
- When connecting locally, either select the application from the list, browse your computer for the exe or shortcut to the application, or type in the full path.
- When using a shortcut from the client, the arguments and working directory from the shortcut will be correctly applied to the application, although the information does not appear in the client.
- When connecting remotely, this option is unavailable.
- "Arguments"
- Stores the most recently used command-line arguments for each of the recently used applications.
- When connecting locally, this will be populated with the most recent arguments that you have passed to the selected application.
- When connecting remotely, this option is unavailable.
- It is invalid to supply arguments in this field without specifying an application name.
- "Working Dir"
- Stores the most recently used working directory for each of the recently used applications if a working directory was specified.
- When connecting locally, this will be populated with the most recent working directory that was used with the selected application.
- When connecting remotely, this option is unavailable.
- It is invalid to supply a working directory in this field without specifying an application name.
- "Platform"
- Select whether the application should be launched with the 32-bit or 64-bit server.
- When connecting locally, this will be populated with the most recent server that you successfully launched the application with.
- When connecting remotely, this option is unavailable.
d) Click "Connect" button
e) "Please select an API" Dialog
- As your application starts up, the client will display the processes that the server is connected to and which APIs are being used.
- When the process that you would like to connect to is listed, and an API "is active", you may select it and click the "OK" button to connect.
- Clicking the "Cancel" button will cancel the connection and shutdown the server along with any launched processes.
Disconnecting from server on localhost will also shutdown the server and the application being analyzed if the client launched it. There are several ways to disconnect.
a) Close the client
- 'X' in the top-right corner of the window
- File->Exit
b) Disconnect, but leave the client running
- File->Disconnect
- Click on the computer icon on the toolbar (tooltip says "Disconnect")