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 BUILD
  43
  44 =head2 Non-threaded Case
  45
  46 Just run ./Configure script from the top directory.
  47 Then give "make" to compile.
  48
  49 =head2 Threaded Case
  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 whcih allows it to link correctly DG/UX's
  61 -lthread library.
  62
  63 If you want to change the installtion 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 ====
  74 Any additional ld flags (NOT including libraries)? [ -pthread]
  75 ====
  76
  77 Instead of -pthread put here -lthread. CGCC-2.7.2.x
  78 that comes with the DG/UX OS does NOT know the -pthread
  79 switch. So your build will fail if you choose the defaults.
  80 After configuration is done correctly give "make" to compile.
  81
  82 =head2 Testing
  83
  84 Issuing a "make test"  will run all the tests.
  85 If the test lib/ftmp-security gives you as a result
  86 something like
  87
  88 =====
  89 lib/ftmp-security....File::Temp::_gettemp:
  90 Parent directory (/tmp/) is not safe (sticky bit not set
  91 when world writable?) at lib/ftmp-security.t line 100
  92 =====
  93
  94 don't panic and just set the sticky bit in your /tmp
  95 directory by doing the following as root:
  96
  97 cd /
  98 chmod +t /tmp (=set the sticky bit to /tmp).
  99
 100 Then rerun the tests. This time all must be OK.
 101
 102 =head2 Installing the built perl
 103
 104 Run the command "make install"
 105
 106 =head1 AUTHOR
 107
 108 Takis Psarogiannakopoulos
 109 Universirty of Cambridge
 110 Centre for Mathematical Sciences
 111 Department of Pure Mathematics
 112 Wilberforce road
 113 Cambridge CB3 0WB , UK
 114 email <takis@xfree86.org>
 115
 116 =head1 SEE ALSO
 117
 118 perl(1).
 119
 120 =cut
 121