README.dgux

   1 If you read this file _as_is_, just ignore the funny characters you
   2 see. It is written in the POD format (see perlpod manpage) which is
   3 specially designed to be readable as is.
   4
   5 =head1 NAME
   6
   7 perldgux - Perl under DG/UX.
   8
   9 =head1 SYNOPSIS
  10
  11 One can read this document in the following formats:
  12
  13         man perldgux
  14         view perl perldgux
  15         explorer perldgux.html
  16         info perldgux
  17
  18 to list some (not all may be available simultaneously), or it may
  19 be read I<as is>: as F<README.dgux>.
  20
  21 =cut
  22
  23 Contents
  24
  25  perldgux - Perl under DG/UX.
  26
  27       NAME
  28       SYNOPSIS
  29       DESCRIPTION
  30       BUILD
  31          -  Non-threaded Case
  32          -  Threaded Case
  33          -  Testing
  34          -  Installing the built perl
  35       AUTHOR
  36       SEE ALSO
  37
  38 =head1 DESCRIPTION
  39
  40 Perl 5.7/8.x for DG/UX ix86 R4.20MU0x
  41
  42 =head1 BUILDING PERL ON DG/UX
  43
  44 =head2 Non-threaded Perl on DG/UX
  45
  46 Just run ./Configure script from the top directory.
  47 Then give "make" to compile.
  48
  49 =head2 Threaded Perl on DG/UX
  50
  51 If you are using as compiler GCC-2.95.x rev(DG/UX)
  52 an easy solution for configuring perl in your DG/UX
  53 machine is to run the command:
  54
  55 ./Configure -Dusethreads -Duse5005threads -des
  56
  57 This will automatically accept all the defaults and
  58 in particular /usr/local/ as installation directory.
  59 Note that GCC-2.95.x rev(DG/UX) knows the switch
  60 -pthread which allows it to link correctly DG/UX's
  61 -lthread library.
  62
  63 If you want to change the installation directory or
  64 have a standard DG/UX with C compiler GCC-2.7.2.x
  65 then you have no choice than to do an interactive
  66 build by issuing the command:
  67
  68 ./Configure -Dusethreads -Duse5005threads
  69
  70 In particular with GCC-2.7.2.x accept all the defaults
  71 and *watch* out for the message:
  72
  73     Any additional ld flags (NOT including libraries)? [ -pthread]
  74
  75 Instead of -pthread put here -lthread. CGCC-2.7.2.x
  76 that comes with the DG/UX OS does NOT know the -pthread
  77 switch. So your build will fail if you choose the defaults.
  78 After configuration is done correctly give "make" to compile.
  79
  80 =head2 Testing Perl on DG/UX
  81
  82 Issuing a "make test"  will run all the tests.
  83 If the test lib/ftmp-security gives you as a result
  84 something like
  85
  86     lib/ftmp-security....File::Temp::_gettemp:
  87     Parent directory (/tmp/) is not safe (sticky bit not set
  88     when world writable?) at lib/ftmp-security.t line 100
  89
  90 don't panic and just set the sticky bit in your /tmp
  91 directory by doing the following as root:
  92
  93 cd /
  94 chmod +t /tmp (=set the sticky bit to /tmp).
  95
  96 Then rerun the tests. This time all must be OK.
  97
  98 =head2 Installing the built perl on DG/UX
  99
 100 Run the command "make install"
 101
 102 =head1 AUTHOR
 103
 104 Takis Psarogiannakopoulos
 105 Universirty of Cambridge
 106 Centre for Mathematical Sciences
 107 Department of Pure Mathematics
 108 Wilberforce road
 109 Cambridge CB3 0WB , UK
 110 email <takis@xfree86.org>
 111
 112 =head1 SEE ALSO
 113
 114 perl(1).
 115
 116 =cut
 117