cpan.3

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

If you have a ReadLine module installed, you can hit \s-1TAB\s0 at any point
of the commandline and \f(CW\*(C`o conf\*(C'\fR will offer you completion for the
built-in subcommands and/or config variable names.
.IP "displaying some help: o conf help" 4
.IX Item "displaying some help: o conf help"
Displays a short help
.IP "displaying current values: o conf [\s-1KEY\s0]" 4
.IX Item "displaying current values: o conf [KEY]"
Displays the current value(s) for this config variable. Without \s-1KEY\s0
displays all subcommands and config variables.
.Sp
Example:
.Sp
.Vb 1
\&  o conf shell
.Ve
.Sp
If \s-1KEY\s0 starts and ends with a slash the string in between is
interpreted as a regular expression and only keys matching this regex
are displayed
.Sp
Example:
.Sp
.Vb 1
\&  o conf /color/
.Ve
.IP "changing of scalar values: o conf \s-1KEY\s0 \s-1VALUE\s0" 4
.IX Item "changing of scalar values: o conf KEY VALUE"
Sets the config variable \s-1KEY\s0 to \s-1VALUE\s0. The empty string can be
specified as usual in shells, with \f(CW\*(Aq\*(Aq\fR or \f(CW""\fR
.Sp
Example:
.Sp
.Vb 1
\&  o conf wget /usr/bin/wget
.Ve
.IP "changing of list values: o conf \s-1KEY\s0 SHIFT|UNSHIFT|PUSH|POP|SPLICE|LIST" 4
.IX Item "changing of list values: o conf KEY SHIFT|UNSHIFT|PUSH|POP|SPLICE|LIST"
If a config variable name ends with \f(CW\*(C`list\*(C'\fR, it is a list. \f(CW\*(C`o conf
KEY shift\*(C'\fR removes the first element of the list, \f(CW\*(C`o conf KEY pop\*(C'\fR
removes the last element of the list. \f(CW\*(C`o conf KEYS unshift LIST\*(C'\fR
prepends a list of values to the list, \f(CW\*(C`o conf KEYS push LIST\*(C'\fR
appends a list of valued to the list.
.Sp
Likewise, \f(CW\*(C`o conf KEY splice LIST\*(C'\fR passes the \s-1LIST\s0 to the according
splice command.
.Sp
Finally, any other list of arguments is taken as a new list value for
the \s-1KEY\s0 variable discarding the previous value.
.Sp
Examples:
.Sp
.Vb 3
\&  o conf urllist unshift http://cpan.dev.local/CPAN
\&  o conf urllist splice 3 1
\&  o conf urllist http://cpan1.local http://cpan2.local ftp://ftp.perl.org
.Ve
.IP "reverting to saved: o conf defaults" 4
.IX Item "reverting to saved: o conf defaults"
Reverts all config variables to the state in the saved config file.
.IP "saving the config: o conf commit" 4
.IX Item "saving the config: o conf commit"
Saves all config variables to the current config file (CPAN/Config.pm
or CPAN/MyConfig.pm that was loaded at start).
.PP
The configuration dialog can be started any time later again by
issuing the command \f(CW\*(C` o conf init \*(C'\fR in the \s-1CPAN\s0 shell. A subset of
the configuration dialog can be run by issuing \f(CW\*(C`o conf init WORD\*(C'\fR
where \s-1WORD\s0 is any valid config variable or a regular expression.
.Sh "Config Variables"
.IX Subsection "Config Variables"
Currently the following keys in the hash reference \f(CW$CPAN::Config\fR are
defined:
.PP
.Vb 10
\&  applypatch         path to external prg
\&  auto_commit        commit all changes to config variables to disk
\&  build_cache        size of cache for directories to build modules
\&  build_dir          locally accessible directory to build modules
\&  build_dir_reuse    boolean if distros in build_dir are persistent
\&  build_requires_install_policy
\&                     to install or not to install when a module is
\&                     only needed for building. yes|no|ask/yes|ask/no
\&  bzip2              path to external prg
\&  cache_metadata     use serializer to cache metadata
\&  commands_quote     prefered character to use for quoting external
\&                     commands when running them. Defaults to double
\&                     quote on Windows, single tick everywhere else;
\&                     can be set to space to disable quoting
\&  check_sigs         if signatures should be verified
\&  colorize_debug     Term::ANSIColor attributes for debugging output
\&  colorize_output    boolean if Term::ANSIColor should colorize output
\&  colorize_print     Term::ANSIColor attributes for normal output
\&  colorize_warn      Term::ANSIColor attributes for warnings
\&  commandnumber_in_prompt
\&                     boolean if you want to see current command number
\&  cpan_home          local directory reserved for this package
\&  curl               path to external prg
\&  dontload_hash      DEPRECATED
\&  dontload_list      arrayref: modules in the list will not be
\&                     loaded by the CPAN::has_inst() routine
\&  ftp                path to external prg
\&  ftp_passive        if set, the envariable FTP_PASSIVE is set for downloads
\&  ftp_proxy          proxy host for ftp requests
\&  getcwd             see below
\&  gpg                path to external prg
\&  gzip               location of external program gzip
\&  histfile           file to maintain history between sessions
\&  histsize           maximum number of lines to keep in histfile
\&  http_proxy         proxy host for http requests
\&  inactivity_timeout breaks interactive Makefile.PLs or Build.PLs
\&                     after this many seconds inactivity. Set to 0 to
\&                     never break.
\&  index_expire       after this many days refetch index files
\&  inhibit_startup_message
\&                     if true, does not print the startup message
\&  keep_source_where  directory in which to keep the source (if we do)
\&  load_module_verbosity
\&                     report loading of optional modules used by CPAN.pm
\&  lynx               path to external prg
\&  make               location of external make program
\&  make_arg           arguments that should always be passed to \*(Aqmake\*(Aq
\&  make_install_make_command
\&                     the make command for running \*(Aqmake install\*(Aq, for
\&                     example \*(Aqsudo make\*(Aq
\&  make_install_arg   same as make_arg for \*(Aqmake install\*(Aq
\&  makepl_arg         arguments passed to \*(Aqperl Makefile.PL\*(Aq
\&  mbuild_arg         arguments passed to \*(Aq./Build\*(Aq
\&  mbuild_install_arg arguments passed to \*(Aq./Build install\*(Aq
\&  mbuild_install_build_command
\&                     command to use instead of \*(Aq./Build\*(Aq when we are
\&                     in the install stage, for example \*(Aqsudo ./Build\*(Aq
\&  mbuildpl_arg       arguments passed to \*(Aqperl Build.PL\*(Aq
\&  ncftp              path to external prg
\&  ncftpget           path to external prg
\&  no_proxy           don\*(Aqt proxy to these hosts/domains (comma separated list)
\&  pager              location of external program more (or any pager)
\&  password           your password if you CPAN server wants one
\&  patch              path to external prg
\&  prefer_installer   legal values are MB and EUMM: if a module comes
\&                     with both a Makefile.PL and a Build.PL, use the
\&                     former (EUMM) or the latter (MB); if the module
\&                     comes with only one of the two, that one will be
\&                     used in any case
\&  prerequisites_policy
\&                     what to do if you are missing module prerequisites
\&                     (\*(Aqfollow\*(Aq automatically, \*(Aqask\*(Aq me, or \*(Aqignore\*(Aq)
\&  prefs_dir          local directory to store per\-distro build options
\&  proxy_user         username for accessing an authenticating proxy
\&  proxy_pass         password for accessing an authenticating proxy
\&  randomize_urllist  add some randomness to the sequence of the urllist
\&  scan_cache         controls scanning of cache (\*(Aqatstart\*(Aq or \*(Aqnever\*(Aq)
\&  shell              your favorite shell
\&  show_unparsable_versions
\&                     boolean if r command tells which modules are versionless
\&  show_upload_date   boolean if commands should try to determine upload date
\&  show_zero_versions boolean if r command tells for which modules $version==0
\&  tar                location of external program tar
\&  tar_verbosity      verbosity level for the tar command
\&  term_is_latin      deprecated: if true Unicode is translated to ISO\-8859\-1
\&                     (and nonsense for characters outside latin range)
\&  term_ornaments     boolean to turn ReadLine ornamenting on/off
\&  test_report        email test reports (if CPAN::Reporter is installed)
\&  unzip              location of external program unzip
\&  urllist            arrayref to nearby CPAN sites (or equivalent locations)
\&  use_sqlite         use CPAN::SQLite for metadata storage (fast and lean)
\&  username           your username if you CPAN server wants one
\&  wait_list          arrayref to a wait server to try (See CPAN::WAIT)
\&  wget               path to external prg
\&  yaml_load_code     enable YAML code deserialisation
\&  yaml_module        which module to use to read/write YAML files
.Ve
.PP
You can set and query each of these options interactively in the cpan
shell with the \f(CW\*(C`o conf\*(C'\fR or the \f(CW\*(C`o conf init\*(C'\fR command as specified below.
.ie n .IP """o conf <scalar option>""" 2
.el .IP "\f(CWo conf <scalar option>\fR" 2
.IX Item "o conf <scalar option>"
prints the current value of the \fIscalar option\fR
.ie n .IP """o conf <scalar option> <value>""" 2
.el .IP "\f(CWo conf <scalar option> <value>\fR" 2
.IX Item "o conf <scalar option> <value>"
Sets the value of the \fIscalar option\fR to \fIvalue\fR
.ie n .IP """o conf <list option>""" 2
.el .IP "\f(CWo conf <list option>\fR" 2
.IX Item "o conf <list option>"
prints the current value of the \fIlist option\fR in MakeMaker's
neatvalue format.
.ie n .IP """o conf <list option> [shift|pop]""" 2
.el .IP "\f(CWo conf <list option> [shift|pop]\fR" 2
.IX Item "o conf <list option> [shift|pop]"
shifts or pops the array in the \fIlist option\fR variable
.ie n .IP """o conf <list option> [unshift|push|splice] <list>""" 2
.el .IP "\f(CWo conf <list option> [unshift|push|splice] <list>\fR" 2
.IX Item "o conf <list option> [unshift|push|splice] <list>"
works like the corresponding perl commands.
.IP "interactive editing: o conf init [MATCH|LIST]" 2
.IX Item "interactive editing: o conf init [MATCH|LIST]"
Runs an interactive configuration dialog for matching variables.
Without argument runs the dialog over all supported config variables.
To specify a \s-1MATCH\s0 the argument must be enclosed by slashes.
.Sp
Examples:
.Sp
.Vb 2
\&  o conf init ftp_passive ftp_proxy
\&  o conf init /color/
.Ve
.Sp
Note: this method of setting config variables often provides more
explanation about the functioning of a variable than the manpage.
.Sh "CPAN::anycwd($path): Note on config variable getcwd"
.IX Subsection "CPAN::anycwd($path): Note on config variable getcwd"
\&\s-1CPAN\s0.pm changes the current working directory often and needs to
determine its own current working directory. Per default it uses
Cwd::cwd but if this doesn't work on your system for some reason,
alternatives can be configured according to the following table:
.IP "cwd" 4
.IX Item "cwd"
Calls Cwd::cwd
.IP "getcwd" 4
.IX Item "getcwd"
Calls Cwd::getcwd
.IP "fastcwd" 4
.IX Item "fastcwd"
Calls Cwd::fastcwd
.IP "backtickcwd" 4
.IX Item "backtickcwd"
Calls the external command cwd.
.Sh "Note on the format of the urllist parameter"
.IX Subsection "Note on the format of the urllist parameter"
urllist parameters are URLs according to \s-1RFC\s0 1738. We do a little
guessing if your \s-1URL\s0 is not compliant, but if you have problems with
\&\f(CW\*(C`file\*(C'\fR URLs, please try the correct format. Either:
.PP
.Vb 1
\&    file://localhost/whatever/ftp/pub/CPAN/
.Ve
.PP
or
.PP
.Vb 1
\&    file:///home/ftp/pub/CPAN/
.Ve
.Sh "The urllist parameter has CD-ROM support"
.IX Subsection "The urllist parameter has CD-ROM support"
The \f(CW\*(C`urllist\*(C'\fR parameter of the configuration table contains a list of
URLs that are to be used for downloading. If the list contains any
\&\f(CW\*(C`file\*(C'\fR URLs, \s-1CPAN\s0 always tries to get files from there first. This
feature is disabled for index files. So the recommendation for the
owner of a CD-ROM with \s-1CPAN\s0 contents is: include your local, possibly
outdated CD-ROM as a \f(CW\*(C`file\*(C'\fR \s-1URL\s0 at the end of urllist, e.g.
.PP
.Vb 1
\&  o conf urllist push file://localhost/CDROM/CPAN
.Ve
.PP
\&\s-1CPAN\s0.pm will then fetch the index files from one of the \s-1CPAN\s0 sites
that come at the beginning of urllist. It will later check for each
module if there is a local copy of the most recent version.
.PP
Another peculiarity of urllist is that the site that we could
successfully fetch the last file from automatically gets a preference
token and is tried as the first site for the next request. So if you
add a new site at runtime it may happen that the previously preferred
site will be tried another time. This means that if you want to disallow
a site for the next transfer, it must be explicitly removed from
urllist.
.Sh "Maintaining the urllist parameter"
.IX Subsection "Maintaining the urllist parameter"
If you have \s-1YAML\s0.pm (or some other \s-1YAML\s0 module configured in
\&\f(CW\*(C`yaml_module\*(C'\fR) installed, \s-1CPAN\s0.pm collects a few statistical data
about recent downloads. You can view the statistics with the \f(CW\*(C`hosts\*(C'\fR
command or inspect them directly by looking into the \f(CW\*(C`FTPstats.yml\*(C'\fR
file in your \f(CW\*(C`cpan_home\*(C'\fR directory.
.PP
To get some interesting statistics it is recommended to set the
\&\f(CW\*(C`randomize_urllist\*(C'\fR parameter that introduces some amount of
randomness into the \s-1URL\s0 selection.
.ie n .Sh "The ""requires""\fP and \f(CW""build_requires"" dependency declarations"
.el .Sh "The \f(CWrequires\fP and \f(CWbuild_requires\fP dependency declarations"
.IX Subsection "The requires and build_requires dependency declarations"
Since \s-1CPAN\s0.pm version 1.88_51 modules declared as \f(CW\*(C`build_requires\*(C'\fR by
a distribution are treated differently depending on the config
variable \f(CW\*(C`build_requires_install_policy\*(C'\fR. By setting
\&\f(CW\*(C`build_requires_install_policy\*(C'\fR to \f(CW\*(C`no\*(C'\fR such a module is not being
installed. It is only built and tested and then kept in the list of
tested but uninstalled modules. As such it is available during the
build of the dependent module by integrating the path to the
\&\f(CW\*(C`blib/arch\*(C'\fR and \f(CW\*(C`blib/lib\*(C'\fR directories in the environment variable
\&\s-1PERL5LIB\s0. If \f(CW\*(C`build_requires_install_policy\*(C'\fR is set ti \f(CW\*(C`yes\*(C'\fR, then
both modules declared as \f(CW\*(C`requires\*(C'\fR and those declared as
\&\f(CW\*(C`build_requires\*(C'\fR are treated alike. By setting to \f(CW\*(C`ask/yes\*(C'\fR or
\&\f(CW\*(C`ask/no\*(C'\fR, \s-1CPAN\s0.pm asks the user and sets the default accordingly.
.Sh "Configuration for individual distributions (\fIDistroprefs\fP)"