Differences
This shows you the differences between two versions of the page.
appendices:commandlinearguments [2017/04/09 16:42] floele drive letter |
appendices:commandlinearguments [2023/01/27 20:31] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Command line arguments ====== | ||
- | The main application cdbxpp.exe does only have one command line argument: You can only specify a file name of a CDBurnerXP compilation file to open it automatically. | ||
- | |||
- | However, the command line version of CDBurnerXP called **cdbxpcmd.exe**, located in the same program folder as the CDBurnerXP main application, has more useful options. | ||
- | |||
- | ===== Syntax ===== | ||
- | |||
- | The first argument specifies the main action. The following main actions exist, exactly **one** of them must be specified: | ||
- | |||
- | <code> | ||
- | --list-drives [lists all available drives] | ||
- | --eject [ejects the disc] | ||
- | --load [closes the tray] | ||
- | --burn-data [burns a data disc] | ||
- | --burn-audio [burns an audio disc] | ||
- | --burn-video [burns a DVD-video, requires v. 4.5 or later] | ||
- | --burn-iso [burns an ISO image] | ||
- | --erase [erases a disc] | ||
- | --wait-for-disc [waits until a disc has been inserted] | ||
- | </code> | ||
- | |||
- | Except for //--list-drives//, all actions need at least one further argument, the //-device// parameter. The //--list-drives// action provides a list of all drives and the drive numbers to use. You can also use a drive letter. | ||
- | |||
- | Example: | ||
- | |||
- | <code>--eject -device:0</code> | ||
- | |||
- | The //--burn-data// and //--burn-audio// actions, take the following additional and (optional) arguments. The square brackets [ ] are part of the command, not indicating something optional. | ||
- | |||
- | ; -dao | ||
- | : Force burning in Disc at Once mode (data or audio discs). Only supported for CD-R/CD-RW (not DVD-R and others). | ||
- | ; -tao (since v. 4.3) | ||
- | : Force burning in Track at Once mode (data or audio discs). | ||
- | : Use this option for **multisession discs**. Also use for burning discs other than CD-R/CD-RW. | ||
- | ; -sao (since v. 4.3) | ||
- | : Force burning in Session at Once mode (data discs only). Only supported for CD-R/CD-RW (not DVD-R and others). | ||
- | ; -close | ||
- | : Closes the disc after burning. | ||
- | ; -eject | ||
- | : Ejects the disc after burning. | ||
- | ; -file[\targetFolder]:sourcePath | ||
- | ; -file:sourcePath (for audio and ISO) | ||
- | : Adds a file from sourcePath to the targetFolder on disc. You can add as many of these directives as you want. A path that contains spaces must be enclosed in double quotes. | ||
- | ; -folder[\targetFolder]:sourcePath | ||
- | ; -folder:sourcePath (for audio and video) | ||
- | : Adds a folder and all its contents to disc. You can add as many of these directives as you want. A path that contains spaces must be enclosed in double quotes. For DVD-video, specify the full path of the VIDEO_TS folder. | ||
- | ; -speed:[[wp>X_(writing_speed)|ratio]] (since 4.3.1, for example "24", "8", "4") | ||
- | : Specifies the speed for burning the disc. | ||
- | ; -sptd (since v. 4.3.8) | ||
- | : Uses the [[http://www.duplexsecure.com/downloads/|SPTD driver]]. May work more reliably, but requires installing the SPTD driver package before. | ||
- | |||
- | The //--burn-data// action takes the following additional arguments: | ||
- | |||
- | ; -import | ||
- | : Imports files on disc before adding more files | ||
- | ; -name:NAME | ||
- | : Changes the disc's name to NAME (as it shows up in Windows Explorer). Maximum length: 16 chars. | ||
- | ; -changefiledates (since v. 4.3.5) | ||
- | : If specified, all files on the disc will lose their original dates and have the date of the burning process. | ||
- | ; -udf:VERSION (since v. 4.3.2, 1.02 is the default) | ||
- | : Changes the file system version. Options available: 1.02, 1.5, 2.0, 2.01, 2.5, 2.6. | ||
- | ; -format:iso (since v. 4.5.1) | ||
- | : Instead of UDF, an ISO/Joliet file system is used for burning. The -udf flag does not apply then. | ||
- | ; -verify (since v. 4.1.3) | ||
- | : Verifies the disc after burning. | ||
- | ; -iso:PATH (since v. 4.1.3) | ||
- | : Instead of burning the disc, creates an ISO image at the specified path. | ||
- | ; -layout:PATH (since v. 4.1.3) | ||
- | : Instead of adding files from the //file// and //folder// options, it loads all contents from a data compilation (DXP file). | ||
- | | ||
- | Example: | ||
- | |||
- | <code>--burn-data -device:0 -file[\]:c:\foo.db | ||
- | -folder[\test]:c:\dell -name:foobar</code> | ||
- | |||
- | The //--burn-video// action takes the following additional arguments (make sure to specify "-folder" as explained above): | ||
- | |||
- | ; -name:NAME | ||
- | : Changes the disc's name to NAME (as it shows up in Windows Explorer). Maximum length: 16 chars. | ||
- | ; -iso:PATH (since v. 4.1.3) | ||
- | : Instead of burning the disc, creates an ISO image at the specified path. | ||
- | |||
- | ===== Return codes / errors ===== | ||
- | |||
- | If the desired action has been performed successfully, the application will return with exit code "0". If any error occurs, a non-zero error code will be returned (check the [[References/errorCodes|full list of error codes]] for more information). | ||
- | |||
- | In case "-sptd" is used and the driver is not installed or could not be loaded successfully, -1 is returned. | ||
- | |||
- | {{template>:sys:version|ver=4.0.025}} |