Creating a module

You create modules in the Project Management area of Klocwork Static Code Analysis.

If you're not already viewing the Projects list, click Projects at the top left.
Click your project in the list. The project details appear on the right.
Click Modules in the project details.
Click Create a new module.
Enter a name for your module, for example, My Tools.
Module names cannot exceed 64 characters and cannot contain apostrophes (') or double quotes (").
If access control has been set up, you can control who can view source code in this module. Note that users must also have the "Access source files" permission for the project.
- Allow all sets a generic rule allowing anyone to see source code in this module.
- Deny all sets a generic rule preventing anyone from seeing source code in this module.
- The Allow user field allows you to grant source code access to specific users.
- The Deny user field allows you to deny source code access to specific users.
For example, to allow only jsmith access to source code in a module, choose Deny all from the drop-down menu and enter jsmith in the Allow user field.
You can specify paths in one of two ways; by using tree selection or by specifying path patterns:
- If you prefer to use tree selection, select the Use tree option. A file tree appears, where you can specifically select folders or files that you want to include as part of the module.
- Alternatively, you can use path patterns. In the Path patterns field, enter an absolute file path or path pattern. This is the default behavior. Click add to add more file paths to this module.
- Whenever possible, use path patterns that include regular expressions so that you avoid creating a very long list of paths. There is a limit to the length of path the system can process; as a best practice, limit the length of a path to 30 000 characters.
Tip: You can use asterisks as wildcards (necessary if the path to your source files changes from build to build). A single asterisk, for example */test or /test/*, performs a non-recursive search, meaning that matches will be limited to the current path level and will not include sub directories. When two asterisks are specified, for example **/test.c or /test/**, a recursive search is performed meaning that matches will occur in the current path and all sub-directories of the current path.
The * and ** path matching was designed to provide enough specificity in path selection to allow deterministic access permission control over individual paths in the customer code base. Normal regex style wild cards can potentially, and unintentionally, allow some paths to sneak in to or be omitted from an access rule.
Example 1
Given the sample file path: /space/workspaces/cvs/ccvs.1.11.18/diff/diff.c
The pattern:
```
    diff  
```
includes any path that contain the text 'diff' in any part of the path.
The pattern:
```
**/ccvs.1.11.18/diff/diff.c   
```
returns a match, since the double-asterisk matches any number of paths (/space/workspaces/cvs in this case). Whereas the pattern:
```
*/ccvs.1.11.18/diff/diff.c
```
does not return a match as * can only match a single file or directory.
Lastly, the pattern:
```
**/diff/**
```
By leading with '**', it matches /space/workspaces/cvs/ccvs.1.11.18 and trailing it with '**' matches all files below the 'diff' directory.
Example 2
To match a specific file under the path: /space/workspaces/cvs/ccvs.1.11.18/ regardless of the minor version number, use the pattern:
```
/space/workspaces/cvs/ccvs.1.11.*/diff/diff.c
```
since the * matches the 18. Or, to match all files under the same path, use the pattern:
```
/space/workspaces/cvs/ccvs.1.11.**
```
Example 3
To match all files that start with 's' and that are under ccvs.1.11.18 and any intermediate directory, use the pattern:
```
**/ccvs.1.11.18/**/s*
```
Lastly, to match all files that have an 's' in them and are under the ccvs.1.11.18 and any intermediate directory, use the pattern:
```
**/ccvs.1.11.18/**/*s*
```
Note: Path patterns and tree selection are not updated in real time. If you switch between the two selections, changes are not reflected until you save the module.
Use the tags field to add information that will be helpful for filtering the module list later.
Click Create to save your new module.