home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _9c5e0db759af00aa7193f18e87e673b5 < prev    next >
Text File  |  2000-03-23  |  7KB  |  178 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>B::Bytecode - Perl compiler's bytecode backend</TITLE>
  5. <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> B::Bytecode - Perl compiler's bytecode backend</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#options">OPTIONS</A></LI>
  26.     <LI><A HREF="#examples">EXAMPLES</A></LI>
  27.     <LI><A HREF="#bugs">BUGS</A></LI>
  28.     <LI><A HREF="#author">AUTHOR</A></LI>
  29. </UL>
  30. <!-- INDEX END -->
  31.  
  32. <HR>
  33. <P>
  34. <H1><A NAME="name">NAME</A></H1>
  35. <P>B::Bytecode - Perl compiler's bytecode backend</P>
  36. <P>
  37. <HR>
  38. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  39. <UL>
  40. <LI>Linux</LI>
  41. <LI>Solaris</LI>
  42. <LI>Windows</LI>
  43. </UL>
  44. <HR>
  45. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  46. <PRE>
  47.         perl -MO=Bytecode[,OPTIONS] foo.pl</PRE>
  48. <P>
  49. <HR>
  50. <H1><A NAME="description">DESCRIPTION</A></H1>
  51. <P>This compiler backend takes Perl source and generates a
  52. platform-independent bytecode encapsulating code to load the
  53. internal structures perl uses to run your program. When the
  54. generated bytecode is loaded in, your program is ready to run,
  55. reducing the time which perl would have taken to load and parse
  56. your program into its internal semi-compiled form. That means that
  57. compiling with this backend will not help improve the runtime
  58. execution speed of your program but may improve the start-up time.
  59. Depending on the environment in which your program runs this may
  60. or may not be a help.</P>
  61. <P>The resulting bytecode can be run with a special byteperl executable
  62. or (for non-main programs) be loaded via the <CODE>byteload_fh</CODE> function
  63. in the <EM>B</EM> module.</P>
  64. <P>
  65. <HR>
  66. <H1><A NAME="options">OPTIONS</A></H1>
  67. <P>If there are any non-option arguments, they are taken to be names of
  68. objects to be saved (probably doesn't work properly yet).  Without
  69. extra arguments, it saves the main program.</P>
  70. <DL>
  71. <DT><STRONG><A NAME="item_%2Dofilename"><STRONG>-ofilename</STRONG></A></STRONG><BR>
  72. <DD>
  73. Output to filename instead of STDOUT.
  74. <P></P>
  75. <DT><STRONG><A NAME="item_%2Dafilename"><STRONG>-afilename</STRONG></A></STRONG><BR>
  76. <DD>
  77. Append output to filename.
  78. <P></P>
  79. <DT><STRONG><A NAME="item_%2D%2D"><STRONG>--</STRONG></A></STRONG><BR>
  80. <DD>
  81. Force end of options.
  82. <P></P>
  83. <DT><STRONG><A NAME="item_%2Df"><STRONG>-f</STRONG></A></STRONG><BR>
  84. <DD>
  85. Force optimisations on or off one at a time. Each can be preceded
  86. by <STRONG>no-</STRONG> to turn the option off (e.g. <STRONG>-fno-compress-nullops</STRONG>).
  87. <P></P>
  88. <DT><STRONG><A NAME="item_%2Dfcompress%2Dnullops"><STRONG>-fcompress-nullops</STRONG></A></STRONG><BR>
  89. <DD>
  90. Only fills in the necessary fields of ops which have
  91. been optimised away by perl's internal compiler.
  92. <P></P>
  93. <DT><STRONG><A NAME="item_%2Dfomit%2Dsequence%2Dnumbers"><STRONG>-fomit-sequence-numbers</STRONG></A></STRONG><BR>
  94. <DD>
  95. Leaves out code to fill in the op_seq field of all ops
  96. which is only used by perl's internal compiler.
  97. <P></P>
  98. <DT><STRONG><A NAME="item_%2Dfbypass%2Dnullops"><STRONG>-fbypass-nullops</STRONG></A></STRONG><BR>
  99. <DD>
  100. If op->op_next ever points to a NULLOP, replaces the op_next field
  101. with the first non-NULLOP in the path of execution.
  102. <P></P>
  103. <DT><STRONG><A NAME="item_%2Dfstrip%2Dsyntax%2Dtree"><STRONG>-fstrip-syntax-tree</STRONG></A></STRONG><BR>
  104. <DD>
  105. Leaves out code to fill in the pointers which link the internal syntax
  106. tree together. They're not needed at run-time but leaving them out
  107. will make it impossible to recompile or disassemble the resulting
  108. program.  It will also stop <CODE>goto label</CODE> statements from working.
  109. <P></P>
  110. <DT><STRONG><A NAME="item_%2DOn"><STRONG>-On</STRONG></A></STRONG><BR>
  111. <DD>
  112. Optimisation level (n = 0, 1, 2, ...). <STRONG>-O</STRONG> means <STRONG>-O1</STRONG>.
  113. <STRONG>-O1</STRONG> sets <STRONG>-fcompress-nullops</STRONG> <STRONG>-fomit-sequence numbers</STRONG>.
  114. <STRONG>-O6</STRONG> adds <STRONG>-fstrip-syntax-tree</STRONG>.
  115. <P></P>
  116. <DT><STRONG><A NAME="item_%2DD"><STRONG>-D</STRONG></A></STRONG><BR>
  117. <DD>
  118. Debug options (concatenated or separate flags like <CODE>perl -D</CODE>).
  119. <P></P>
  120. <DT><STRONG><A NAME="item_%2DDo"><STRONG>-Do</STRONG></A></STRONG><BR>
  121. <DD>
  122. Prints each OP as it's processed.
  123. <P></P>
  124. <DT><STRONG><A NAME="item_%2DDb"><STRONG>-Db</STRONG></A></STRONG><BR>
  125. <DD>
  126. Print debugging information about bytecompiler progress.
  127. <P></P>
  128. <DT><STRONG><A NAME="item_%2DDa"><STRONG>-Da</STRONG></A></STRONG><BR>
  129. <DD>
  130. Tells the (bytecode) assembler to include source assembler lines
  131. in its output as bytecode comments.
  132. <P></P>
  133. <DT><STRONG><A NAME="item_%2DDC"><STRONG>-DC</STRONG></A></STRONG><BR>
  134. <DD>
  135. Prints each CV taken from the final symbol tree walk.
  136. <P></P>
  137. <DT><STRONG><A NAME="item_%2DS"><STRONG>-S</STRONG></A></STRONG><BR>
  138. <DD>
  139. Output (bytecode) assembler source rather than piping it
  140. through the assembler and outputting bytecode.
  141. <P></P>
  142. <DT><STRONG><A NAME="item_%2Dm"><STRONG>-m</STRONG></A></STRONG><BR>
  143. <DD>
  144. Compile as a module rather than a standalone program. Currently this
  145. just means that the bytecodes for initialising <CODE>main_start</CODE>,
  146. <CODE>main_root</CODE> and <CODE>curpad</CODE> are omitted.
  147. <P></P></DL>
  148. <P>
  149. <HR>
  150. <H1><A NAME="examples">EXAMPLES</A></H1>
  151. <PRE>
  152.     perl -MO=Bytecode,-O6,-o,foo.plc foo.pl</PRE>
  153. <PRE>
  154.     perl -MO=Bytecode,-S foo.pl > foo.S
  155.     assemble foo.S > foo.plc</PRE>
  156. <P>Note that <CODE>assemble</CODE> lives in the <CODE>B</CODE> subdirectory of your perl
  157. library directory. The utility called perlcc may also be used to 
  158. help make use of this compiler.</P>
  159. <PRE>
  160.     perl -MO=Bytecode,-m,-oFoo.pmc Foo.pm</PRE>
  161. <P>
  162. <HR>
  163. <H1><A NAME="bugs">BUGS</A></H1>
  164. <P>Plenty. Current status: experimental.</P>
  165. <P>
  166. <HR>
  167. <H1><A NAME="author">AUTHOR</A></H1>
  168. <P>Malcolm Beattie, <CODE>mbeattie@sable.ox.ac.uk</CODE></P>
  169. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  170. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  171. <STRONG><P CLASS=block> B::Bytecode - Perl compiler's bytecode backend</P></STRONG>
  172. </TD></TR>
  173. </TABLE>
  174.  
  175. </BODY>
  176.  
  177. </HTML>
  178.