.perl_wrapper
Package: WA2L/edrc 1.5.57
Section: General Commands (1)
Updated: 31 January 2015
Index
Return to Main Contents
NAME
perl_wrapper - wrap Perl scripts to ensure perl startup
SYNOPSIS
edrc/bin/perlscript
->
.perl_wrapper
edrc/lib/perlscript
->
.perl_wrapper
AVAILABILITY
WA2L/edrc
DESCRIPTION
Wrap Perl scripts to avoid using
#!/usr/bin/perl
or similar path names in the magic key. This enhances the portability
of WA2L/edrc commands written in Perl to systems where
perl
is not
installed in the default install locations.
perl
has to be installed in
/bin/,
/sbin/,
/usr/local/bin/
or
/usr/contrib/bin/.
Further
perl
locations can be configured in the config file
perl_wrapper.cfg.
The Perl modules bundled with WA2L/edrc that are
installed in
lib/perl/pm/<perl-revision>/
are included in the Perl library path
(@INC)
and the
ld
environment variables
($SHLIB_PATH, $LD_LIBRARY_PATH)
are expanded to the directory
lib/<OS-Id>/libs/
that might contain additional needed shared libraries.
To start a new command thru the
.perl_wrapper,
follow the following steps:
- 1.)
-
create a symlink to the new command in the
edrc/bin/
or
edrc/lib/
directory depending on your needs:
[ /opt/edrc/bin ]
[ root@acme001 ][*edrc*/bash]: ln -s .perl_wrapper new_cmd
- 2.)
-
install the Perl script in the
edrc/lib/perl/
directory:
[ /opt/edrc/lib/perl ]
[ root@acme001 ][*edrc*/bash]: vi new_cmd
[ /opt/edrc/lib/perl ]
[ root@acme001 ][*edrc*/bash]: chmod 644 new_cmd
OPTIONS
-
ENVIRONMENT
-
EXIT STATUS
- 101
-
shell
(perl)
not found. If
perl
is installed on the system and you get this error, add
the
perl
location in the configuration file
perl_wrapper.cfg.
- 102
-
the Perl script to be started that should be
located in
lib/perl/
does not exist.
- 103
-
user calling the command has no permission to access/execute
the called
perlscript.
- 106
-
configuration file
perl_wrapper.cfg
does not exist.
- 107
-
the
.perl_wrapper
was called directly.
FILES
- etc/perl_wrapper.cfg
-
configuration file for the
.perl_wrapper
command.
- lib/perl/
-
location of the wrapped Perl scripts. This
files should have the file permissions
644
to show, that those scripts should not be started
directly.
- lib/perl/pm/<perl-revision>/
-
location of the perl modules bundled with WA2L/edrc.
- lib/<OS-Id>/libs/
-
locations of the provided shared libraries for a certain
operating system
(OS-Id).
EXAMPLES
-
SEE ALSO
edrcintro(1),
binprobe(1m),
cmdlist(1m),
daemon_wrapper(1),
java_wrapper(1),
ksh_wrapper(1),
lua_wrapper(1),
ln(1),
ld(1),
osid(3),
os_wrapper(1),
perl(1),
perlenv(3),
perlversion(3),
perl_modules(3),
perl_wrapper.cfg(4),
pmdesc(1),
shlib(3)
NOTES
-
BUGS
-
AUTHOR
perl_wrapper was developed by Christian Walther. Send suggestions
and bug reports to wa2l@users.sourceforge.net .
COPYRIGHT
Copyright © 2015
Christian Walther
This is free software; see
edrc/doc/COPYING
for copying conditions. There is ABSOLUTELY NO WARRANTY; not
even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
This document was created by man2html
using the manual pages.
Time: 22:46:42 GMT, April 07, 2025