Command Line switches

Previous Next

To offer maximum comfort and flexibility to developers, DEScoder provides a complete command line interface.
Thus, all main operations can be run using command line parameters. Both single file encryption and project compilation are available.

In generally, all switches can be specified using - or / indicators, switches are not case-sensitive, and there should be no extra space around the - and / indicators.



Common switches


-keep  or  /keep

this option forces to keep "intermediate" files after encryption;
during encryption, a number of internal files are created for several compression and encryption stages - normally, these files are deleted automatically;
for troubleshooting, if the encrypted Lisp does not work properly, but the original Lisp file does, those "intermediate" files can be kept for analysis;
normally, Lisp developers will not need to use this option


-nocompress  or  /nocompress

this option disables "Lisp Code Compression", which is by default active;
before encryption, the Lisp and DCL source file(s) are compressed to remove all unnecessary white-space characters and linefeeds;
for troubleshooting, if the compressed and encrypted Lisp / DCL does not work properly, but the original Lisp / DCL file does, this option can be used to disable compression, to ensure that the final Lisp / DCL code still works;
if such cases are encountered, please send us a sample file as feedback (as this indicates a program error) !



Single File mode


there is no particular command line switch necessary !

any filename provided as command line argument is interpreted as Lisp source file by default; except for filenames using .prv;
filenames using .prv extensions are treated as project definition files;
=> if filename is an existing project filename, the project is compiled, creating target filename as defined by the project;
=> if filename is an existing Lisp file, the Lisp file is encrypted, creating .des filename in same folder as source file.


Wildcards are supported for Single File mode !

you can specify wildcards in usual way to encrypt a set of Lisp source files;



Project mode


-project  or  /project

this option instructs DEScoder to treat the provided filename as the name of a project definition, regardless of the filename extension;
this option is only necessary, if the project filename is given without .prv extension, or when using an extension other than .prv;



Examples


Single file mode


DEScoder.exe  d:\Lisp\Dictionary.lsp

creates encrypted Lisp file d:\Lisp\Dictionary.des


DEScoder.exe  d:\Lisp\Dictionary.src

creates encrypted Lisp file d:\Lisp\Dictionary.des


DEScoder.exe  d:\Lisp\Dict*.lsp

creates encrypted Lisp files *.des for all Lisp source files matching d:\Lisp\Dict*.lsp pattern


DEScoder.exe  -keep  d:\Lisp\Dictionary.lsp

creates encrypted Lisp file d:\Lisp\Dictionary.des and keeps intermediate files in same folder d:\Lisp\



Project mode


DEScoder.exe  d:\Lisp\Dictionary.prv

compiles the project d:\Lisp\Dictionary.prv and creates the encrypted target file as specified in project


DEScoder.exe  /keep  d:\Lisp\Dictionary.prv

compiles the project d:\Lisp\Dictionary.prv, creates the encrypted target file as specified in project and keeps intermediate files


DEScoder.exe  /project  d:\Lisp\Dictionary

compiles the project d:\Lisp\Dictionary.prv and creates the encrypted target file as specified in project;
as .prv filename extension is not specified, the /project option is necessary