cpanplus::module.3

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

.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "CPANPLUS::Module 3"
.TH CPANPLUS::Module 3 "2007-12-18" "perl v5.10.0" "Perl Programmers Reference Guide"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
CPANPLUS::Module
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 2
\&    ### get a module object from the CPANPLUS::Backend object
\&    my $mod = $cb\->module_tree(\*(AqSome::Module\*(Aq);
\&
\&    ### accessors
\&    $mod\->version;
\&    $mod\->package;
\&
\&    ### methods
\&    $mod\->fetch;
\&    $mod\->extract;
\&    $mod\->install;
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\f(CW\*(C`CPANPLUS::Module\*(C'\fR creates objects from the information in the
source files. These can then be used to query and perform actions
on, like fetching or installing.
.PP
These objects should only be created internally. For \f(CW\*(C`fake\*(C'\fR objects,
there's the \f(CW\*(C`CPANPLUS::Module::Fake\*(C'\fR class. To obtain a module object
consult the \f(CW\*(C`CPANPLUS::Backend\*(C'\fR documentation.
.SH "CLASS METHODS"
.IX Header "CLASS METHODS"
.Sh "accessors ()"
.IX Subsection "accessors ()"
Returns a list of all accessor methods to the object
.SH "ACCESSORS"
.IX Header "ACCESSORS"
An objects of this class has the following accessors:
.IP "name" 4
.IX Item "name"
Name of the module.
.IP "module" 4
.IX Item "module"
Name of the module.
.IP "version" 4
.IX Item "version"
Version of the module. Defaults to '0.0' if none was provided.
.IP "path" 4
.IX Item "path"
Extended path on the mirror.
.IP "comment" 4
.IX Item "comment"
Any comment about the module \*(-- largely unused.
.IP "package" 4
.IX Item "package"
The name of the package.
.IP "description" 4
.IX Item "description"
Description of the module \*(-- only registered modules have this.
.IP "dslip" 4
.IX Item "dslip"
The five character dslip string, that represents meta-data of the
module \*(-- again, only registered modules have this.
.IP "status" 4
.IX Item "status"
The \f(CW\*(C`CPANPLUS::Module::Status\*(C'\fR object associated with this object.
(see below).
.IP "author" 4
.IX Item "author"
The \f(CW\*(C`CPANPLUS::Module::Author\*(C'\fR object associated with this object.
.IP "parent" 4
.IX Item "parent"
The \f(CW\*(C`CPANPLUS::Internals\*(C'\fR object that spawned this module object.
.SH "STATUS ACCESSORS"
.IX Header "STATUS ACCESSORS"
\&\f(CW\*(C`CPANPLUS\*(C'\fR caches a lot of results from method calls and saves data
it collected along the road for later reuse.
.PP
\&\f(CW\*(C`CPANPLUS\*(C'\fR uses this internally, but it is also available for the end
user. You can get a status object by calling:
.PP
.Vb 1
\&    $modobj\->status
.Ve
.PP
You can then query the object as follows:
.IP "installer_type" 4
.IX Item "installer_type"
The installer type used for this distribution. Will be one of
\&'makemaker' or 'build'. This determines whether \f(CW\*(C`CPANPLUS::Dist::MM\*(C'\fR
or \f(CW\*(C`CPANPLUS::Dist::Build\*(C'\fR will be used to build this distribution.
.IP "dist_cpan" 4
.IX Item "dist_cpan"
The dist object used to do the CPAN-side of the installation. Either
a \f(CW\*(C`CPANPLUS::Dist::MM\*(C'\fR or \f(CW\*(C`CPANPLUS::Dist::Build\*(C'\fR object.
.IP "dist" 4
.IX Item "dist"
The custom dist object used to do the operating specific side of the
installation, if you've chosen to use this. For example, if you've
chosen to install using the \f(CW\*(C`ports\*(C'\fR format, this may be a
\&\f(CW\*(C`CPANPLUS::Dist::Ports\*(C'\fR object.
.Sp
Undefined if you didn't specify a separate format to install through.
.IP "prereqs" 4
.IX Item "prereqs"
A hashref of prereqs this distribution was found to have. Will look
something like this:
.Sp
.Vb 1
\&    { Carp  => 0.01, strict => 0 }
.Ve
.Sp
Might be undefined if the distribution didn't have any prerequisites.
.IP "signature" 4
.IX Item "signature"
Flag indicating, if a signature check was done, whether it was \s-1OK\s0 or
not.
.IP "extract" 4
.IX Item "extract"
The directory this distribution was extracted to.
.IP "fetch" 4
.IX Item "fetch"
The location this distribution was fetched to.
.IP "readme" 4
.IX Item "readme"
The text of this distributions \s-1README\s0 file.
.IP "uninstall" 4
.IX Item "uninstall"
Flag indicating if an uninstall call was done successfully.
.IP "created" 4
.IX Item "created"
Flag indicating if the \f(CW\*(C`create\*(C'\fR call to your dist object was done
successfully.
.IP "installed" 4
.IX Item "installed"
Flag indicating if the \f(CW\*(C`install\*(C'\fR call to your dist object was done
successfully.
.IP "checksums" 4
.IX Item "checksums"
The location of this distributions \s-1CHECKSUMS\s0 file.
.IP "checksum_ok" 4
.IX Item "checksum_ok"
Flag indicating if the checksums check was done successfully.
.IP "checksum_value" 4
.IX Item "checksum_value"
The checksum value this distribution is expected to have
.SH "METHODS"
.IX Header "METHODS"
.ie n .Sh "$self = CPANPLUS::Module::new( \s-1OPTIONS\s0 )"
.el .Sh "\f(CW$self\fP = CPANPLUS::Module::new( \s-1OPTIONS\s0 )"
.IX Subsection "$self = CPANPLUS::Module::new( OPTIONS )"