Skip to content

CSSS Exit Codes

Jump to bottom
stuajnht edited this page May 13, 2017 · 1 revision

Introduction

CSSS returns a variety of exit codes depending on what has happened during its runtime. If you are calling CSSS from a script that is used to finalise the image before use (such as clearing temporary files, accounts or history) then you can use the return code to see if you can continue or need to investigate why there was a problem.

Listed below are those exit codes and what they are part of or mean.

Note: If there is no exit code returned, then CSSS is running in either "observe" or "start" modes.

CSSS

Exit Code 0

CSSS has performed any actions required successfully, such as checking the issue files for errors or preparing the program for image capture and release. You can continue to shutdown the computer and take an image.

Bootstrap Checks

Exit Code 1

There were no required arguments passed to CSSS. Please run CSSS.exe --help to see what needs to be passed, or view the arguments online.

Init Checks

Exit Code 10

CSSS was either not able to identify the Operating System or Version number of it, or you are attempting to run CSSS on an unsupported Operating System or Version. Please see the requirements to run CSSS.

Exit Code 11

To prevent any unexpected repeated points notifications or the scoring report running time jumping around, only one instance of CSSS is allowed to be run. If you are attempting to run it again CSSS will error out. Either kill the existing running process of CSSS, or pass the --multiple argument to CSSS to allow multiple instances of it to run at once.

ℹ️ Running CSSS with the --multiple argument is only intended for use in development. It should not be passed during normal usage

Exit Code 12

The --prepare argument has been passed to CSSS, but it is not running with administrative privileges. As CSSS needs to modify a few system files to allow itself to run during system start-up, it needs to be run as an elevated process. Please try running CSSS again, but using sudo (Linux) or "Run as administrator" (WinNT).

Kernel

Exit Code 20

CSSS has run into an internal problem. This is most likely due to a coding bug, so please report what happened when this issue occurred.

ℹ️ For developers: The CSSS kernel class attempted to start, but the init class hasn't yet been called to set up environment variables

Clone this wiki locally