home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _74e7abdb30715ebd79dc1609c31859dc < prev    next >
Text File  |  2000-03-23  |  12KB  |  236 lines
  1. <HTML>
  2. <HEAD>
  3. <TITLE>README.hpux - Perl version 5 on Hewlett-Packard Unix systems</TITLE>
  4. <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
  5. <LINK REV="made" HREF="mailto:">
  6. </HEAD>
  7.  
  8. <BODY>
  9. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  10. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  11. <STRONG><P CLASS=block> README.hpux - Perl version 5 on Hewlett-Packard Unix systems</P></STRONG>
  12. </TD></TR>
  13. </TABLE>
  14.  
  15. <A NAME="__index__"></A>
  16. <!-- INDEX BEGIN -->
  17.  
  18. <UL>
  19.  
  20.     <LI><A HREF="#name">NAME</A></LI>
  21.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  22.     <UL>
  23.  
  24.         <LI><A HREF="#compiling perl 5 on hpux">Compiling Perl 5 on HP-UX</A></LI>
  25.         <LI><A HREF="#parisc">PA-RISC</A></LI>
  26.         <LI><A HREF="#parisc 1.0">PA-RISC 1.0</A></LI>
  27.         <LI><A HREF="#parisc 1.1">PA-RISC 1.1</A></LI>
  28.         <LI><A HREF="#parisc 2.0">PA-RISC 2.0</A></LI>
  29.         <LI><A HREF="#portability between parisc versions">Portability Between PA-RISC Versions</A></LI>
  30.         <LI><A HREF="#building dynamic extensions on hpux">Building Dynamic Extensions on HP-UX</A></LI>
  31.         <LI><A HREF="#the hp ansi c compiler">The HP ANSI C Compiler</A></LI>
  32.         <LI><A HREF="#using large files with perl">Using Large Files with Perl</A></LI>
  33.         <LI><A HREF="#threaded perl">Threaded Perl</A></LI>
  34.         <LI><A HREF="#64bit perl">64-bit Perl</A></LI>
  35.         <LI><A HREF="#gdbm and threads">GDBM and Threads</A></LI>
  36.         <LI><A HREF="#nfs filesystems and utime(2)">NFS filesystems and <A HREF="../../lib/Pod/perlfunc.html#item_utime"><CODE>utime(2)</CODE></A></A></LI>
  37.     </UL>
  38.  
  39.     <LI><A HREF="#author">AUTHOR</A></LI>
  40.     <LI><A HREF="#date">DATE</A></LI>
  41. </UL>
  42. <!-- INDEX END -->
  43.  
  44. <HR>
  45. <P>
  46. <H1><A NAME="name">NAME</A></H1>
  47. <P>README.hpux - Perl version 5 on Hewlett-Packard Unix (HP-UX) systems</P>
  48. <P>
  49. <HR>
  50. <H1><A NAME="description">DESCRIPTION</A></H1>
  51. <P>This document describes various features of HP's Unix operating system (HP-UX)
  52. that will affect how Perl version 5 (hereafter just Perl) is compiled and/or
  53. runs.</P>
  54. <P>
  55. <H2><A NAME="compiling perl 5 on hpux">Compiling Perl 5 on HP-UX</A></H2>
  56. <P>When compiling Perl, the use of an ANSI C compiler is highly recommended.
  57. The C compiler that ships with all HP-UX systems is a K&R compiler that
  58. should only be used to build new kernels.</P>
  59. <P>Perl can be compiled with either HP's ANSI C compiler or with gcc.  The
  60. former is recommended, as not only can it compile Perl with no difficulty,
  61. but also can take advantage of features listed later that require the use
  62. of HP compiler-specific command-line flags.</P>
  63. <P>If you decide to use gcc, make sure your installation is recent and complete,
  64. and be sure to read the Perl README file for more gcc-specific details.</P>
  65. <P>
  66. <H2><A NAME="parisc">PA-RISC</A></H2>
  67. <P>HP's current Unix systems run on its own Precision Architecture (PA-RISC) chip.
  68. HP-UX used to run on the Motorola MC68000 family of chips, but any machine with
  69. this chip in it is quite obsolete and this document will not attempt to address
  70. issues for compiling Perl on the Motorola chipset.</P>
  71. <P>The most recent version of PA-RISC at the time of this document's last update
  72. is 2.0.</P>
  73. <P>
  74. <H2><A NAME="parisc 1.0">PA-RISC 1.0</A></H2>
  75. <P>The original version of PA-RISC, HP no longer sells any system with this chip.</P>
  76. <P>The following systems contain PA-RISC 1.0 chips:</P>
  77. <PRE>
  78.     600, 635, 645, 800, 808, 815, 822, 825, 832, 834, 835, 840,
  79.     842, 845, 850, 852, 855, 860, 865, 870, 890</PRE>
  80. <P>
  81. <H2><A NAME="parisc 1.1">PA-RISC 1.1</A></H2>
  82. <P>An upgrade to the PA-RISC design, it shipped for many years in many different
  83. system.</P>
  84. <P>The following systems contain with PA-RISC 1.1 chips:</P>
  85. <PRE>
  86.     705, 710, 712, 715, 720, 722, 725, 728, 730, 735, 743, 745, 747, 750,
  87.     755, 770, 807S, 817S, 827S, 837S, 847S, 857S, 867S, 877S, 887S, 897S,
  88.     D200, D210, D220, D230, D250, D260, D310, D320, D330, D350, D360, D400,
  89.     E25, E35, E45, E55, F10, F20, F30, G30, G40, G50, G60, G70, H30, H40,
  90.     H50, H60, H70, I30, I40, I50, I60, I70, K100, K200, K210, K220, K400,
  91.     K410, K420, T500, T520</PRE>
  92. <P>
  93. <H2><A NAME="parisc 2.0">PA-RISC 2.0</A></H2>
  94. <P>The most recent upgrade to the PA-RISC design, it added support for 64-bit
  95. integer data.</P>
  96. <P>The following systems contain PA-RISC 2.0 chips (this is very likely to be
  97. out of date):</P>
  98. <PRE>
  99.     D270, D280, D370, D380, K250, K260, K370, K380, K450, K460, K570, K580,
  100.     T600, V2200</PRE>
  101. <P>A complete list of models at the time the OS was built is in the file
  102. /opt/langtools/lib/sched.models.
  103. The first column corresponds to the output of the ``uname -m'' command
  104. (without the leading ``9000/'').
  105. The second column is the PA-RISC version
  106. and the third column is the exact chip type used.</P>
  107. <P>
  108. <H2><A NAME="portability between parisc versions">Portability Between PA-RISC Versions</A></H2>
  109. <P>An executable compiled on a PA-RISC 2.0 platform will not execute on a
  110. PA-RISC 1.1 platform, even if they are running the same version of HP-UX.
  111. If you are building Perl on a PA-RISC 2.0 platform and want that Perl to
  112. to also run on a PA-RISC 1.1, the compiler flags +DAportable and +DS32
  113. should be used.</P>
  114. <P>It is no longer possible to compile PA-RISC 1.0 executables on either the
  115. PA-RISC 1.1 or 2.0 platforms.</P>
  116. <P>
  117. <H2><A NAME="building dynamic extensions on hpux">Building Dynamic Extensions on HP-UX</A></H2>
  118. <P>HP-UX supports dynamically loadable libraries (shared libraries).
  119. Shared libraries end with the suffix .sl.</P>
  120. <P>Shared libraries created on a platform using a particular PA-RISC version
  121. are not usable on platforms using an earlier PA-RISC version by default.
  122. However, this backwards compatibility may be enabled using the same
  123. +DAportable compiler flag (with the same PA-RISC 1.0 caveat mentioned above).</P>
  124. <P>To create a shared library, the following steps must be performed:</P>
  125. <PRE>
  126.     1. Compile source modules with +z or +Z flag to create a .o module
  127.        which contains Position-Independent Code (PIC).  The linker will
  128.        tell you in the next step if +Z was needed.</PRE>
  129. <PRE>
  130.     2. Link the shared library using the -b flag.  If the code calls
  131.        any functions in other system libraries (e.g., libm), it must
  132.        be included on this line.</PRE>
  133. <P>(Note that these steps are usually handled automatically by the extension's
  134. Makefile).</P>
  135. <P>If these dependent libraries are not listed at shared library creation
  136. time, you will get fatal ``Unresolved symbol'' errors at run time when the
  137. library is loaded.</P>
  138. <P>You may create a shared library that referers to another library, which
  139. may be either an archive library or a shared library.  If it is a
  140. shared library, this is called a ``dependent library''.
  141. The dependent library's name is recorded in the main shared library,
  142. but it is not linked into the shared library.
  143. Instead, it is loaded when the main shared library is loaded.</P>
  144. <P>If the referred library is an archive library, then it is treated as a
  145. simple collection of .o modules (all of which must contain PIC).  These
  146. modules are then linked into the shared library.</P>
  147. <P>Note that it is okay to create a library which contains a dependent library
  148. that is already linked into perl.</P>
  149. <P>It is no longer possible to link PA-RISC 1.0 shared libraries.</P>
  150. <P>
  151. <H2><A NAME="the hp ansi c compiler">The HP ANSI C Compiler</A></H2>
  152. <P>When using this compiler to build Perl, you should make sure that
  153. the flag -Aa is added to the cpprun and cppstdin variables in the
  154. config.sh file.</P>
  155. <P>
  156. <H2><A NAME="using large files with perl">Using Large Files with Perl</A></H2>
  157. <P>Beginning with HP-UX version 10.20, files larger than 2GB (2^31) may be
  158. created and manipulated.
  159. Three separate methods of doing this are available.
  160. Of these methods,
  161. the best method for Perl is to compile using the -D_FILE_OFFSET_BITS=64
  162. compiler flag.
  163. This causes Perl to be compiled using structures and functions in which
  164. these are 64 bits wide, rather than 32 bits wide.</P>
  165. <P>There are only two drawbacks to this approach:
  166. the first is that the seek and tell functions (both the builtin version
  167. and the POSIX module's version) will not correctly
  168. function for these large files
  169. (the offset arguments in seek and tell are implemented as type long).
  170. The second is that any extension which calls any file-manipulating C function
  171. will need to be recompiled using the above-mentioned -D_FILE_OFFSET_BITS=64
  172. flag.
  173. The list of functions that will need to recompiled is:
  174. creat,        fgetpos,    fopen,
  175. freopen,    fsetpos,    fstat,
  176. fstatvfs,    fstatvfsdev,    ftruncate,
  177. ftw,        lockf,        lseek,
  178. lstat,        mmap,        nftw,
  179. open,        prealloc,    stat,
  180. statvfs,    statvfsdev,    tmpfile,
  181. truncate,    getrlimit,    setrlimit</P>
  182. <P>
  183. <H2><A NAME="threaded perl">Threaded Perl</A></H2>
  184. <P>It is impossible to compile a version of threaded Perl on any version of
  185. HP-UX before 10.30, and it is strongly suggested that you be running on
  186. HP-UX 11.00 at least.</P>
  187. <P>To compile Perl with thread, add -Dusethreads to the arguments of Configure.
  188. Ensure that the -D_POSIX_C_SOURCE=199506L compiler flag is automatically
  189. added to the list of flags.  Also make sure that -lpthread is listed before
  190. -lc in the list of libraries to link Perl with.</P>
  191. <P>As of the date of this document, Perl threads are not fully supported on HP-UX.</P>
  192. <P>
  193. <H2><A NAME="64bit perl">64-bit Perl</A></H2>
  194. <P>Beginning with HP-UX 11.00, programs compiled under HP-UX can take advantage
  195. of the LP64 programming environment (LP64 means Longs and Pointers are 64 bits
  196. wide).</P>
  197. <P>Work is being performed on Perl to make it 64-bit compliant on all versions
  198. of Unix.  Once this is complete, scalar variables will be able to hold
  199. numbers larger than 2^32 with complete precision.</P>
  200. <P>As of the date of this document, Perl is not 64-bit compliant on HP-UX.</P>
  201. <P>Should a user wish to experiment with compiling Perl in the LP64 environment,
  202. the following steps must be taken: libraries must be searched only within
  203. /lib/pa20_64, the compiler flag +DD64 must be used, and the C library is
  204. now located at /lib/pa20_64/libc.sl.</P>
  205. <P>On the brighter side, the large file problem goes away, as longs are now
  206. 64 bits wide.</P>
  207. <P>
  208. <H2><A NAME="gdbm and threads">GDBM and Threads</A></H2>
  209. <P>If you attempt to compile Perl with threads on an 11.X system and also link
  210. in the GDBM library, then Perl will immediately core dump when it starts up.
  211. The only workaround at this point is to relink the GDBM library under 11.X,
  212. then relink it into Perl.</P>
  213. <P>
  214. <H2><A NAME="nfs filesystems and utime(2)">NFS filesystems and <A HREF="../../lib/Pod/perlfunc.html#item_utime"><CODE>utime(2)</CODE></A></A></H2>
  215. <P>If you are compiling Perl on a remotely-mounted NFS filesystem, the test
  216. io/fs.t may fail on test #18.
  217. This appears to be a bug in HP-UX and no fix is currently available.</P>
  218. <P>
  219. <HR>
  220. <H1><A NAME="author">AUTHOR</A></H1>
  221. <P>Jeff Okamoto <<A HREF="mailto:okamoto@corp.hp.com">okamoto@corp.hp.com</A>></P>
  222. <P>With much assistance regarding shared libraries from Marc Sabatella.</P>
  223. <P>
  224. <HR>
  225. <H1><A NAME="date">DATE</A></H1>
  226. <P>Version 0.2: 1999/03/01</P>
  227. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  228. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  229. <STRONG><P CLASS=block> README.hpux - Perl version 5 on Hewlett-Packard Unix systems</P></STRONG>
  230. </TD></TR>
  231. </TABLE>
  232.  
  233. </BODY>
  234.  
  235. </HTML>
  236.