ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/App-Staticperl/staticperl.pod
(Generate patch)

Comparing App-Staticperl/staticperl.pod (file contents):
Revision 1.41 by root, Thu May 19 18:58:19 2011 UTC vs.
Revision 1.43 by root, Sun Jun 26 17:26:52 2011 UTC

882=item C<STATICPERL> 882=item C<STATICPERL>
883 883
884The directory where staticperl stores all its files 884The directory where staticperl stores all its files
885(default: F<~/.staticperl>). 885(default: F<~/.staticperl>).
886 886
887=item C<DLCACHE>
888
889The path to a directory (will be created if it doesn't exist) where
890downloaded perl sources are being cached, to avoid downloading them
891again. The default is empty, which means there is no cache.
892
893=item C<PERL_VERSION>
894
895The perl version to install - default is currently C<5.12.3>, but C<5.8.9>
896is also a good choice (5.8.9 is much smaller than 5.12.3, while 5.10.1 is
897about as big as 5.12.3).
898
887=item C<PERL_MM_USE_DEFAULT>, C<EV_EXTRA_DEFS>, ... 899=item C<PERL_MM_USE_DEFAULT>, C<EV_EXTRA_DEFS>, ...
888 900
889Usually set to C<1> to make modules "less inquisitive" during their 901Usually set to C<1> to make modules "less inquisitive" during their
890installation, you can set any environment variable you want - some modules 902installation, you can set any environment variable you want - some modules
891(such as L<Coro> or L<EV>) use environment variables for further tweaking. 903(such as L<Coro> or L<EV>) use environment variables for further tweaking.
892
893=item C<PERL_VERSION>
894
895The perl version to install - default is currently C<5.12.3>, but C<5.8.9>
896is also a good choice (5.8.9 is much smaller than 5.12.3, while 5.10.1 is
897about as big as 5.12.3).
898 904
899=item C<PERL_PREFIX> 905=item C<PERL_PREFIX>
900 906
901The prefix where perl gets installed (default: F<$STATICPERL/perl>), 907The prefix where perl gets installed (default: F<$STATICPERL/perl>),
902i.e. where the F<bin> and F<lib> subdirectories will end up. 908i.e. where the F<bin> and F<lib> subdirectories will end up.
1167twice the address space needed for stacks). 1173twice the address space needed for stacks).
1168 1174
1169If you use C<linuxthreads.old>, then you should also be aware that 1175If you use C<linuxthreads.old>, then you should also be aware that
1170uClibc shares C<errno> between all threads when statically linking. See 1176uClibc shares C<errno> between all threads when statically linking. See
1171L<http://lists.uclibc.org/pipermail/uclibc/2010-June/044157.html> for a 1177L<http://lists.uclibc.org/pipermail/uclibc/2010-June/044157.html> for a
1172workaround (And L<https://bugs.uclibc.org/2089> for discussion). 1178workaround (and L<https://bugs.uclibc.org/2089> for discussion).
1173 1179
1174C<ccache> support is also recommended, especially if you want 1180C<ccache> support is also recommended, especially if you want
1175to play around with buildroot options. Enabling the C<miniperl> 1181to play around with buildroot options. Enabling the C<miniperl>
1176package will probably enable all options required for a successful 1182package will probably enable all options required for a successful
1177perl build. F<staticperl> itself additionally needs either C<wget> 1183perl build. F<staticperl> itself additionally needs either C<wget>
1185it from working properly in a chroot - either use dash (and link it to 1191it from working properly in a chroot - either use dash (and link it to
1186F</bin/sh> inside the chroot) or link busybox to F</bin/sh>, using it's 1192F</bin/sh> inside the chroot) or link busybox to F</bin/sh>, using it's
1187built-in ash shell. 1193built-in ash shell.
1188 1194
1189Finally, you need F</dev/null> inside the chroot for many scripts to work 1195Finally, you need F</dev/null> inside the chroot for many scripts to work
1190- F<cp /dev/null output/target/dev> or bind-mounting your F</dev> will 1196- either F<cp /dev/null output/target/dev> or bind-mounting your F</dev>
1191both provide this. 1197will provide this.
1192 1198
1193After you have compiled and set up your buildroot target, you can copy 1199After you have compiled and set up your buildroot target, you can copy
1194F<staticperl> from the C<App::Staticperl> distribution or from your 1200F<staticperl> from the C<App::Staticperl> distribution or from your
1195perl f<bin> directory (if you installed it) into the F<output/target> 1201perl F<bin> directory (if you installed it) into the F<output/target>
1196filesystem, chroot inside and run it. 1202filesystem, chroot inside and run it.
1197 1203
1198=head1 RECIPES / SPECIFIC MODULES 1204=head1 RECIPES / SPECIFIC MODULES
1199 1205
1200This section contains some common(?) recipes and information about 1206This section contains some common(?) recipes and information about

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines