The cssplit Command Manual Page

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO
AUTHOR

NAME

cssplit - Split a CScout processing script into smaller scripts

SYNOPSIS

cssplit [-h] -s N file [file ...]

DESCRIPTION

The cssplit command-line program splits a CScout processing script into N smaller scripts for parallel or distributed processing. Each output script is named using a zero-padded sequence, starting with file-0000.cs.

The input is read from the specified file(s), and the output files are written into the current working directory.

This tool is useful for distributing the workload of a large CScout analysis across multiple scripts for efficiency or manageability.

OPTIONS

-s, --shards N

Specifies the number of output scripts to generate. The input processing script is divided into N approximately equal parts. Each output script contains the appropriate subset of the input commands to ensure no loss of information during the split. Compilation units from multiple inter-dependent projects (e.g. different configurations of the same executable) are distributed to the scripts so as to maximize locality of reference.

-h, --help

Display a brief usage message and exit.

EXAMPLE

To split an input processing script into 4 smaller scripts:

cssplit -s 4  make.cs

This will create the following files in the current directory:

file-0000.cs
file-0001.cs
file-0002.cs
file-0003.cs

Each file contains a portion of the original processing script.

SEE ALSO

cscout(1), cscut(1), csmake(1)

AUTHOR

(C) Copyright 2024-2025 Diomidis Spinellis.