xref: /OK3568_Linux_fs/yocto/meta-openembedded/meta-perl/README (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyunmeta-perl
2*4882a593Smuzhiyun=========
3*4882a593SmuzhiyunThis layer provides commonly-used perl related recipes such as perl libraries
4*4882a593Smuzhiyunin the Comprehensive Perl Archive Network.
5*4882a593Smuzhiyun
6*4882a593SmuzhiyunContents and Help
7*4882a593Smuzhiyun-----------------
8*4882a593Smuzhiyun
9*4882a593SmuzhiyunIn this section the contents of the layer is listed, along with a short
10*4882a593Smuzhiyunhelp for each package.
11*4882a593Smuzhiyun
12*4882a593Smuzhiyun         -- libdbi-perl --
13*4882a593Smuzhiyun         The DBI is a database access module for the Perl programming language.
14*4882a593Smuzhiyun         It defines a set of methods, variables, and conventions that provide
15*4882a593Smuzhiyun         a consistent database interface, independent of the actual database
16*4882a593Smuzhiyun         being used.
17*4882a593Smuzhiyun                      |<- Scope of DBI ->|
18*4882a593Smuzhiyun                           .-.   .--------------.   .-------------.
19*4882a593Smuzhiyun           .-------.       | |---| XYZ Driver   |---| XYZ Engine  |
20*4882a593Smuzhiyun           | Perl  |       | |   `--------------'   `-------------'
21*4882a593Smuzhiyun           | script|  |A|  |D|   .--------------.   .-------------.
22*4882a593Smuzhiyun           | using |--|P|--|B|---|Oracle Driver |---|Oracle Engine|
23*4882a593Smuzhiyun           | DBI   |  |I|  |I|   `--------------'   `-------------'
24*4882a593Smuzhiyun           | API   |       | |...
25*4882a593Smuzhiyun           |methods|       | |... Other drivers
26*4882a593Smuzhiyun           `-------'       | |...
27*4882a593Smuzhiyun                           `-'
28*4882a593Smuzhiyun
29*4882a593Smuzhiyun        -- libdbd-sqlite-perl --
30*4882a593Smuzhiyun        DBD::SQLite is a Perl DBI driver for SQLite, that includes the entire
31*4882a593Smuzhiyun        thing in the distribution. So in order to get a fast transaction capable
32*4882a593Smuzhiyun        RDBMS working for your perl project you simply have to install this
33*4882a593Smuzhiyun        module, and nothing else.
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun        usage: there is a test case to show you how it works
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun        1) vim local.conf:
38*4882a593Smuzhiyun        ...
39*4882a593Smuzhiyun        IMAGE_INSTALL:append = " libdbd-sqlite-perl"
40*4882a593Smuzhiyun        PERL_DBM_TEST = "1"
41*4882a593Smuzhiyun        ...
42*4882a593Smuzhiyun        2) build core-image-sato and boot the target
43*4882a593Smuzhiyun
44*4882a593Smuzhiyun        3) run "sqlite-perl-test.pl" on target. This script includes five
45*4882a593Smuzhiyun           operations create/insert/update/delete/select to do with a table.
46*4882a593Smuzhiyun
47*4882a593Smuzhiyun        More information can be found in the recipe's git log.
48*4882a593Smuzhiyun
49*4882a593SmuzhiyunDependencies
50*4882a593Smuzhiyun------------
51*4882a593Smuzhiyun
52*4882a593SmuzhiyunThis layer depends on:
53*4882a593Smuzhiyun
54*4882a593Smuzhiyun  URI: git://git.openembedded.org/openembedded-core
55*4882a593Smuzhiyun  branch: kirkstone
56*4882a593Smuzhiyun
57*4882a593SmuzhiyunAdding the meta-perl layer to your build
58*4882a593Smuzhiyun---------------------------------------
59*4882a593Smuzhiyun
60*4882a593SmuzhiyunIn order to use this layer, you need to make the build system aware of
61*4882a593Smuzhiyunit.
62*4882a593Smuzhiyun
63*4882a593SmuzhiyunAssuming the meta-perl layer exists at the top-level of your
64*4882a593Smuzhiyunyocto build tree, you can add it to the build system by adding the
65*4882a593Smuzhiyunlocation of the meta-perl layer to bblayers.conf, along with any
66*4882a593Smuzhiyunother layers needed. e.g.:
67*4882a593Smuzhiyun
68*4882a593Smuzhiyun  BBLAYERS ?= " \
69*4882a593Smuzhiyun    /path/to/oe-core/meta \
70*4882a593Smuzhiyun    /path/to/layer/meta-perl \
71*4882a593Smuzhiyun
72*4882a593SmuzhiyunMaintenance
73*4882a593Smuzhiyun-----------
74*4882a593Smuzhiyun
75*4882a593SmuzhiyunSend patches / pull requests to openembedded-devel@lists.openembedded.org with
76*4882a593Smuzhiyun'[meta-perl][kirkstone]' in the subject.
77*4882a593Smuzhiyun
78*4882a593SmuzhiyunWhen sending single patches, please using something like:
79*4882a593Smuzhiyungit send-email -M -1 --to openembedded-devel@lists.openembedded.org --subject-prefix='meta-perl][kirkstone][PATCH'
80*4882a593Smuzhiyun
81*4882a593SmuzhiyunLayer maintainers: Armin Kuster <akuster808@gmail.com>
82*4882a593Smuzhiyun
83*4882a593Smuzhiyun
84*4882a593SmuzhiyunLicense
85*4882a593Smuzhiyun-------
86*4882a593Smuzhiyun
87*4882a593SmuzhiyunAll metadata is MIT licensed unless otherwise stated. Source code included
88*4882a593Smuzhiyunin tree for individual recipes is under the LICENSE stated in each recipe
89*4882a593Smuzhiyun(.bb file) unless otherwise stated.
90