CLion 2019.1 Help

Enabling and Configuring Perforce Integration

The Perforce Integration is disabled by default. If you want to perform Perforce-related operations right from CLion, enable the integration at the IDE level and associate the project root or specific directories with Perforce. The general procedure is described in the section Enable Version Control.

To enable Perforce integration for a project or directory

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), click Version Control.

  2. In the Version Control page, that opens, point to the desired root.

  3. From the VCS list, choose Perforce.

If you specify a wrong client workspace, and your project roots do not match with the workspace roots, CLion displays a popup with a warning.

Click Inspect to view and fix the discrepancies.

To configure Perforce integration

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), click Perforce under Version Control. The Perforce page opens.

  2. To establish live connection to the Perforce server, select the Perforce is online checkbox.

  3. Specify which credentials you want to use for connecting to the Perforce server.
    • To use the connection settings from your P4CONFIG files, choose the Use P4CONFIG or default connection option.

      If you are using P4CONFIG files for configuration, CLion shows what config files it has found and what other default settings are used. This way you can be sure that your P4CONFIG files are detected and taken into account.

    • To configure connection manually, choose the Use connection parameters option and specify the following settings in the corresponding text boxes:
      1. The Port the Perforce client will listen to.

      2. The Client name.

      3. Your User name and Password to authenticate to the server.

  4. To use ticket-based authentication, select the Login authentication checkbox. Otherwise, password-based authentication will be used. In either cases CLion uses the login name and password specified in the dialog or stored in the P4CONFIG files.

  5. To attempt to log on the Perforce server without authentication, select the Try to login silently checkbox.

  6. To have CLion create a P4.output file and store the output of Perforce commands in it, select the Dump Perforce Commands to: checkbox.

  7. Specify the path to the Perforce executable file. Click Test Connection to make sure your settings ensure successful connection.

  8. In the Timeout field, specify the lapse of time in seconds during which CLion waits for response from the server. If the server does not respond in due time, the user is prompted to disable integration.

  9. To enable displaying the branch history of a specified file, including all file branch points, edits, and merges, select the Show branching history checkbox.

  10. To have CLion point at committed changes that are also integrated to other changelists and provide information on the target changelists that received the content in question, select the Show integrated changelists in committed changes checkbox.

  11. To get the user interface for attaching and detaching Perforce jobs to changelists, select the Enable Perforce Jobs Support checkbox.

Last modified: 24 July 2019

See Also