Section: User Commands (1)
Updated: Aug 25, 2015
- ENVIRONMENT VARIABLES
- REPORT BUGS TO
shc - Generic shell script compiler
[ -e date ]
[ -m addr ]
[ -i iopt ]
[ -x cmnd ]
[ -l lopt ]
[ -o outfile ]
[ -ABCDhUv ]
creates a stripped binary executable version of the script
specified with -f on the command line.
The binary version will get a .x extension appended by default if
outfile is not defined with [-o outfile] option
and will usually be a bit larger in size than the original ascii code.
Generated C source code is saved in a file with the extension .x.c
or in a file specified with appropriate option
If you supply an expiration date with the -e option the
compiled binary will refuse to run after the date specified.
The message "Please contact your provider" will be displayed instead.
This message can be changed with the -m option.
You can compile any kind of shell script, but you need to supply valid
-i, -x and -l options.
The compiled binary will still be dependent on the shell specified
in the first line of the shell code (i.e. #!/bin/sh), thus shc does not create
completely independent binaries.
shc itself is not a compiler such as cc, it rather encodes and
encrypts a shell script and generates C source code with the added expiration
capability. It then uses the system compiler to compile a stripped binary
which behaves exactly like the original script. Upon execution, the compiled binary
will decrypt and execute the code with the shell -c option.
Unfortunatelly, it will not give you any speed improvement as a real C program would.
shc's main purpose is to protect your shell scripts from modification or
inspection. You can use it if you wish to distribute your scripts but don't
want them to be easily readable by other people.
The command line options are:
- -e date
Expiration date in dd/mm/yyyy format [none]
- -m message
message to display upon expiration ["Please contact your provider"]
- -f script_name
File name of the script to compile
- -i inline_option
Inline option for the shell interpreter i.e: -e
- -x comand
eXec command, as a printf format i.e: exec(\\'%s\\',@ARGV);
- -l last_option
Last shell option i.e: --
- -o filename
output to the file specified by filename
Relax security. Make a redistributable binary which executes on
different systems running the same operating system. You can release
your binary with this option for others to use
Switch on debug exec calls
Make binary to be untraceable (using strace, ptrace, truss, etc.)
Display license and exit
Display abstract and exit
Compile for BusyBox
Display help and exit
C compiler command [cc]
C compiler flags [none]
Compile a script which can be run on other systems with the trace
option enabled (without -U flag):
shc -f myscript -o mybinary
The maximum size of the script that could be executed once compiled is limited
by the operating system configuration parameter
REPORT BUGS TO
Time: 06:09:34 GMT, August 25, 2015