LXR perl/README.dgux

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