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.20 by root, Fri Dec 10 20:29:17 2010 UTC vs.
Revision 1.23 by root, Mon Dec 13 18:08:01 2010 UTC

… …
122often as necessary. 122often as necessary.
123 123
124=head1 THE F<STATICPERL> SCRIPT 124=head1 THE F<STATICPERL> SCRIPT
125 125
126This module installs a script called F<staticperl> into your perl 126This module installs a script called F<staticperl> into your perl
127binary directory. The script is fully self-contained, and can be used 127binary directory. The script is fully self-contained, and can be
128without perl (for example, in an uClibc chroot environment). In fact, 128used without perl (for example, in an uClibc chroot environment). In
129it can be extracted from the C<App::Staticperl> distribution tarball as 129fact, it can be extracted from the C<App::Staticperl> distribution
130F<bin/staticperl>, without any installation. 130tarball as F<bin/staticperl>, without any installation. The
131newest (possibly alpha) version can also be downloaded from
132L<http://staticperl.schmorp.de/staticperl>.
131 133
132F<staticperl> interprets the first argument as a command to execute, 134F<staticperl> interprets the first argument as a command to execute,
133optionally followed by any parameters. 135optionally followed by any parameters.
134 136
135There are two command categories: the "phase 1" commands which deal with 137There are two command categories: the "phase 1" commands which deal with
… …
701 703
702More commonly, you would either activate 64 bit integer support 704More commonly, you would either activate 64 bit integer support
703(C<-Duse64bitint>), or disable large files support (-Uuselargefiles), to 705(C<-Duse64bitint>), or disable large files support (-Uuselargefiles), to
704reduce filesize further. 706reduce filesize further.
705 707
706=item C<PERL_CPPFLAGS>, C<PERL_OPTIMIZE>, C<PERL_LDFLAGS>, C<PERL_LIBS> 708=item C<PERL_CC>, C<PERL_CPPFLAGS>, C<PERL_OPTIMIZE>, C<PERL_LDFLAGS>, C<PERL_LIBS>
707 709
708These flags are passed to perl's F<Configure> script, and are generally 710These flags are passed to perl's F<Configure> script, and are generally
709optimised for small size (at the cost of performance). Since they also 711optimised for small size (at the cost of performance). Since they also
710contain subtle workarounds around various build issues, changing these 712contain subtle workarounds around various build issues, changing these
711usually requires understanding their default values - best look at the top 713usually requires understanding their default values - best look at the top
… …
714=back 716=back
715 717
716=head4 Variables you probably I<do not want> to override 718=head4 Variables you probably I<do not want> to override
717 719
718=over 4 720=over 4
721
722=item C<MAKE>
723
724The make command to use - default is C<make>.
719 725
720=item C<MKBUNDLE> 726=item C<MKBUNDLE>
721 727
722Where F<staticperl> writes the C<mkbundle> command to 728Where F<staticperl> writes the C<mkbundle> command to
723(default: F<$STATICPERL/mkbundle>). 729(default: F<$STATICPERL/mkbundle>).
… …
1051 PERL_CONFIGURE="$PERL_CONFIGURE -U$sym" 1057 PERL_CONFIGURE="$PERL_CONFIGURE -U$sym"
1052 done 1058 done
1053 } 1059 }
1054 1060
1055This mostly gains space when linking staticaly, as the functions will 1061This mostly gains space when linking staticaly, as the functions will
1056liekly not be linked in. The gain for dynamically-linked binaries is 1062likely not be linked in. The gain for dynamically-linked binaries is
1057smaller. 1063smaller.
1058 1064
1059Also, this leaves C<gethostbyname> in - not only is it actually used 1065Also, this leaves C<gethostbyname> in - not only is it actually used
1060often, the L<Socket> module also exposes it, so leaving it out usually 1066often, the L<Socket> module also exposes it, so leaving it out usually
1061gains little. Why Socket exposes a C function that is in the core already 1067gains little. Why Socket exposes a C function that is in the core already

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines