extutils::mm_unix.3

视频监控网络部分的协议ddns,的模块的实现代码,请大家大胆指正.

.Vb 1
\&  my $make_frag = $MM\->shdist_target;
.Ve
.Sp
Converts the distdir into a shell archive.
.IP "dlsyms (o)" 4
.IX Item "dlsyms (o)"
Used by some \s-1OS\s0' to define \s-1DL_FUNCS\s0 and \s-1DL_VARS\s0 and write the *.exp files.
.Sp
Normally just returns an empty string.
.IP "dynamic_bs (o)" 4
.IX Item "dynamic_bs (o)"
Defines targets for bootstrap files.
.IP "dynamic_lib (o)" 4
.IX Item "dynamic_lib (o)"
Defines how to produce the *.so (or equivalent) files.
.IP "exescan" 4
.IX Item "exescan"
Deprecated method. Use libscan instead.
.IP "extliblist" 4
.IX Item "extliblist"
Called by init_others, and calls ext ExtUtils::Liblist. See
ExtUtils::Liblist for details.
.IP "find_perl" 4
.IX Item "find_perl"
Finds the executables \s-1PERL\s0 and \s-1FULLPERL\s0
.IP "fixin" 4
.IX Item "fixin"
.Vb 1
\&  $mm\->fixin(@files);
.Ve
.Sp
Inserts the sharpbang or equivalent magic number to a set of \f(CW@files\fR.
.IP "force (o)" 4
.IX Item "force (o)"
Writes an empty \s-1FORCE:\s0 target.
.IP "guess_name" 4
.IX Item "guess_name"
Guess the name of this package by examining the working directory's
name. MakeMaker calls this only if the developer has not supplied a
\&\s-1NAME\s0 attribute.
.IP "has_link_code" 4
.IX Item "has_link_code"
Returns true if C, \s-1XS\s0, \s-1MYEXTLIB\s0 or similar objects exist within this
object that need a compiler. Does not descend into subdirectories as
\&\fIneeds_linking()\fR does.
.IP "init_dirscan" 4
.IX Item "init_dirscan"
Scans the directory structure and initializes \s-1DIR\s0, \s-1XS\s0, \s-1XS_FILES\s0,
C, C_FILES, O_FILES, H, H_FILES, \s-1PL_FILES\s0, \s-1EXE_FILES\s0.
.Sp
Called by init_main.
.IP "init_MANPODS" 4
.IX Item "init_MANPODS"
Determines if man pages should be generated and initializes \s-1MAN1PODS\s0
and \s-1MAN3PODS\s0 as appropriate.
.IP "init_MAN1PODS" 4
.IX Item "init_MAN1PODS"
Initializes \s-1MAN1PODS\s0 from the list of \s-1EXE_FILES\s0.
.IP "init_MAN3PODS" 4
.IX Item "init_MAN3PODS"
Initializes \s-1MAN3PODS\s0 from the list of \s-1PM\s0 files.
.IP "init_PM" 4
.IX Item "init_PM"
Initializes \s-1PMLIBDIRS\s0 and \s-1PM\s0 from \s-1PMLIBDIRS\s0.
.IP "init_DIRFILESEP" 4
.IX Item "init_DIRFILESEP"
Using / for Unix.  Called by init_main.
.IP "init_main" 4
.IX Item "init_main"
Initializes \s-1AR\s0, \s-1AR_STATIC_ARGS\s0, \s-1BASEEXT\s0, \s-1CONFIG\s0, \s-1DISTNAME\s0, \s-1DLBASE\s0,
\&\s-1EXE_EXT\s0, \s-1FULLEXT\s0, \s-1FULLPERL\s0, \s-1FULLPERLRUN\s0, \s-1FULLPERLRUNINST\s0, INST_*,
INSTALL*, \s-1INSTALLDIRS\s0, \s-1LIB_EXT\s0, \s-1LIBPERL_A\s0, \s-1MAP_TARGET\s0, \s-1NAME\s0,
\&\s-1OBJ_EXT\s0, \s-1PARENT_NAME\s0, \s-1PERL\s0, \s-1PERL_ARCHLIB\s0, \s-1PERL_INC\s0, \s-1PERL_LIB\s0,
\&\s-1PERL_SRC\s0, \s-1PERLRUN\s0, \s-1PERLRUNINST\s0, \s-1PREFIX\s0, \s-1VERSION\s0,
\&\s-1VERSION_SYM\s0, \s-1XS_VERSION\s0.
.IP "init_others" 4
.IX Item "init_others"
Initializes \s-1EXTRALIBS\s0, \s-1BSLOADLIBS\s0, \s-1LDLOADLIBS\s0, \s-1LIBS\s0, \s-1LD_RUN_PATH\s0, \s-1LD\s0,
\&\s-1OBJECT\s0, \s-1BOOTDEP\s0, \s-1PERLMAINCC\s0, \s-1LDFROM\s0, \s-1LINKTYPE\s0, \s-1SHELL\s0, \s-1NOOP\s0,
\&\s-1FIRST_MAKEFILE\s0, \s-1MAKEFILE_OLD\s0, \s-1NOECHO\s0, \s-1RM_F\s0, \s-1RM_RF\s0, \s-1TEST_F\s0,
\&\s-1TOUCH\s0, \s-1CP\s0, \s-1MV\s0, \s-1CHMOD\s0, \s-1UMASK_NULL\s0, \s-1ECHO\s0, \s-1ECHO_N\s0
.IP "init_linker" 4
.IX Item "init_linker"
Unix has no need of special linker flags.
.IP "init_PERL" 4
.IX Item "init_PERL"
.Vb 1
\&    $mm\->init_PERL;
.Ve
.Sp
Called by init_main.  Sets up \s-1ABSPERL\s0, \s-1PERL\s0, \s-1FULLPERL\s0 and all the
*PERLRUN* permutations.
.Sp
.Vb 2
\&    PERL is allowed to be miniperl
\&    FULLPERL must be a complete perl
\&
\&    ABSPERL is PERL converted to an absolute path
\&
\&    *PERLRUN contains everything necessary to run perl, find it\*(Aqs
\&         libraries, etc...
\&
\&    *PERLRUNINST is *PERLRUN + everything necessary to find the
\&         modules being built.
.Ve
.IP "init_platform" 4
.IX Item "init_platform"
.PD 0
.IP "platform_constants" 4
.IX Item "platform_constants"
.PD
Add MM_Unix_VERSION.
.IP "init_PERM" 4
.IX Item "init_PERM"
.Vb 1
\&  $mm\->init_PERM
.Ve
.Sp
Called by init_main.  Initializes PERL_*
.IP "init_xs" 4
.IX Item "init_xs"
.Vb 1
\&    $mm\->init_xs
.Ve
.Sp
Sets up macros having to do with \s-1XS\s0 code.  Currently just \s-1INST_STATIC\s0,
\&\s-1INST_DYNAMIC\s0 and \s-1INST_BOOT\s0.
.IP "install (o)" 4
.IX Item "install (o)"
Defines the install target.
.IP "installbin (o)" 4
.IX Item "installbin (o)"
Defines targets to make and to install \s-1EXE_FILES\s0.
.IP "linkext (o)" 4
.IX Item "linkext (o)"
Defines the linkext target which in turn defines the \s-1LINKTYPE\s0.
.IP "lsdir" 4
.IX Item "lsdir"
Takes as arguments a directory name and a regular expression. Returns
all entries in the directory that match the regular expression.
.IP "macro (o)" 4
.IX Item "macro (o)"
Simple subroutine to insert the macros defined by the macro attribute
into the Makefile.
.IP "makeaperl (o)" 4
.IX Item "makeaperl (o)"
Called by staticmake. Defines how to write the Makefile to produce a
static new perl.
.Sp
By default the Makefile produced includes all the static extensions in
the perl library. (Purified versions of library files, e.g.,
DynaLoader_pure_p1_c0_032.a are automatically ignored to avoid link errors.)
.IP "makefile (o)" 4
.IX Item "makefile (o)"
Defines how to rewrite the Makefile.
.IP "maybe_command" 4
.IX Item "maybe_command"
Returns true, if the argument is likely to be a command.
.IP "needs_linking (o)" 4
.IX Item "needs_linking (o)"
Does this module need linking? Looks into subdirectory objects (see
also \fIhas_link_code()\fR)
.IP "parse_abstract" 4
.IX Item "parse_abstract"
parse a file and return what you think is the \s-1ABSTRACT\s0
.IP "parse_version" 4
.IX Item "parse_version"
.Vb 1
\&    my $version = MM\->parse_version($file);
.Ve
.Sp
Parse a \f(CW$file\fR and return what \f(CW$VERSION\fR is set to by the first assignment.
It will return the string \*(L"undef\*(R" if it can't figure out what \f(CW$VERSION\fR
is. \f(CW$VERSION\fR should be for all to see, so \f(CW\*(C`our $VERSION\*(C'\fR or plain \f(CW$VERSION\fR
are okay, but \f(CW\*(C`my $VERSION\*(C'\fR is not.
.Sp
\&\fIparse_version()\fR will try to \f(CW\*(C`use version\*(C'\fR before checking for \f(CW$VERSION\fR so the following will work.
.Sp
.Vb 1
\&    $VERSION = qv(1.2.3);
.Ve
.IP "pasthru (o)" 4
.IX Item "pasthru (o)"
Defines the string that is passed to recursive make calls in
subdirectories.
.IP "perl_script" 4
.IX Item "perl_script"
Takes one argument, a file name, and returns the file name, if the
argument is likely to be a perl script. On MM_Unix this is true for
any ordinary, readable file.
.IP "perldepend (o)" 4
.IX Item "perldepend (o)"
Defines the dependency from all *.h files that come with the perl
distribution.
.IP "perm_rw (o)" 4
.IX Item "perm_rw (o)"
Returns the attribute \f(CW\*(C`PERM_RW\*(C'\fR or the string \f(CW644\fR.
Used as the string that is passed
to the \f(CW\*(C`chmod\*(C'\fR command to set the permissions for read/writeable files.
MakeMaker chooses \f(CW644\fR because it has turned out in the past that
relying on the umask provokes hard-to-track bug reports.
When the return value is used by the perl function \f(CW\*(C`chmod\*(C'\fR, it is
interpreted as an octal value.
.IP "perm_rwx (o)" 4
.IX Item "perm_rwx (o)"
Returns the attribute \f(CW\*(C`PERM_RWX\*(C'\fR or the string \f(CW755\fR,
i.e. the string that is passed
to the \f(CW\*(C`chmod\*(C'\fR command to set the permissions for executable files.
See also perl_rw.
.IP "pm_to_blib" 4
.IX Item "pm_to_blib"
Defines target that copies all files in the hash \s-1PM\s0 to their
destination and autosplits them. See \*(L"\s-1DESCRIPTION\s0\*(R" in ExtUtils::Install
.IP "post_constants (o)" 4
.IX Item "post_constants (o)"
Returns an empty string per default. Dedicated to overrides from
within Makefile.PL after all constants have been defined.
.IP "post_initialize (o)" 4
.IX Item "post_initialize (o)"
Returns an empty string per default. Used in Makefile.PLs to add some
chunk of text to the Makefile after the object is initialized.
.IP "postamble (o)" 4
.IX Item "postamble (o)"
Returns an empty string. Can be used in Makefile.PLs to write some
text to the Makefile at the end.
.IP "ppd" 4
.IX Item "ppd"
Defines target that creates a \s-1PPD\s0 (Perl Package Description) file
for a binary distribution.
.IP "prefixify" 4
.IX Item "prefixify"
.Vb 1
\&  $MM\->prefixify($var, $prefix, $new_prefix, $default);
.Ve
.Sp
Using either \f(CW$MM\fR\->{uc \f(CW$var\fR} || \f(CW$Config\fR{lc \f(CW$var\fR}, it will attempt to
replace it's \f(CW$prefix\fR with a \f(CW$new_prefix\fR.
.Sp
Should the \f(CW$prefix\fR fail to match \fI\s-1AND\s0\fR a \s-1PREFIX\s0 was given as an
argument to \fIWriteMakefile()\fR it will set it to the \f(CW$new_prefix\fR +
\&\f(CW$default\fR.  This is for systems whose file layouts don't neatly fit into
our ideas of prefixes.
.Sp
This is for heuristics which attempt to create directory structures
that mirror those of the installed perl.
.Sp
For example:
.Sp
.Vb 1
\&    $MM\->prefixify(\*(Aqinstallman1dir\*(Aq, \*(Aq/usr\*(Aq, \*(Aq/home/foo\*(Aq, \*(Aqman/man1\*(Aq);
.Ve
.Sp
this will attempt to remove '/usr' from the front of the
\&\f(CW$MM\fR\->{\s-1INSTALLMAN1DIR\s0} path (initializing it to \f(CW$Config\fR{installman1dir}
if necessary) and replace it with '/home/foo'.  If this fails it will
simply use '/home/foo/man/man1'.
.IP "processPL (o)" 4
.IX Item "processPL (o)"
Defines targets to run *.PL files.
.IP "quote_paren" 4
.IX Item "quote_paren"
Backslashes parentheses \f(CW\*(C`()\*(C'\fR in command line arguments.
Doesn't handle recursive Makefile \f(CW\*(C`$(...)\*(C'\fR constructs,
but handles simple ones.
.IP "replace_manpage_separator" 4
.IX Item "replace_manpage_separator"
.Vb 1
\&  my $man_name = $MM\->replace_manpage_separator($file_path);
.Ve
.Sp
Takes the name of a package, which may be a nested package, in the
form 'Foo/Bar.pm' and replaces the slash with \f(CW\*(C`::\*(C'\fR or something else
safe for a man page file name.  Returns the replacement.
.IP "cd" 4
.IX Item "cd"
.PD 0
.IP "oneliner" 4
.IX Item "oneliner"
.IP "quote_literal" 4
.IX Item "quote_literal"
.IP "escape_newlines" 4
.IX Item "escape_newlines"
.IP "max_exec_len" 4
.IX Item "max_exec_len"
.PD
Using \s-1POSIX::ARG_MAX\s0.  Otherwise falling back to 4096.
.IP "static (o)" 4
.IX Item "static (o)"
Defines the static target.
.IP "static_lib (o)" 4
.IX Item "static_lib (o)"
Defines how to produce the *.a (or equivalent) files.
.IP "staticmake (o)" 4
.IX Item "staticmake (o)"
Calls makeaperl.
.IP "subdir_x (o)" 4
.IX Item "subdir_x (o)"
Helper subroutine for subdirs
.IP "subdirs (o)" 4
.IX Item "subdirs (o)"
Defines targets to process subdirectories.
.IP "test (o)" 4
.IX Item "test (o)"
Defines the test targets.
.IP "test_via_harness (override)" 4
.IX Item "test_via_harness (override)"
For some reason which I forget, Unix machines like to have
\&\s-1PERL_DL_NONLAZY\s0 set for tests.
.IP "test_via_script (override)" 4
.IX Item "test_via_script (override)"
Again, the \s-1PERL_DL_NONLAZY\s0 thing.
.IP "tools_other (o)" 4
.IX Item "tools_other (o)"
.Vb 1
\&    my $make_frag = $MM\->tools_other;
.Ve
.Sp
Returns a make fragment containing definitions for the macros \fIinit_others()\fR 
initializes.
.IP "tool_xsubpp (o)" 4
.IX Item "tool_xsubpp (o)"
Determines typemaps, xsubpp version, prototype behaviour.
.IP "all_target" 4
.IX Item "all_target"
Build man pages, too
.IP "top_targets (o)" 4
.IX Item "top_targets (o)"
Defines the targets all, subdirs, config, and O_FILES
.IP "writedoc" 4
.IX Item "writedoc"
Obsolete, deprecated method. Not used since Version 5.21.
.IP "xs_c (o)" 4
.IX Item "xs_c (o)"
Defines the suffix rules to compile \s-1XS\s0 files to C.
.IP "xs_cpp (o)" 4
.IX Item "xs_cpp (o)"
Defines the suffix rules to compile \s-1XS\s0 files to \*(C+.
.IP "xs_o (o)" 4
.IX Item "xs_o (o)"
Defines suffix rules to go from \s-1XS\s0 to object files directly. This is
only intended for broken make implementations.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
ExtUtils::MakeMaker