a34b05d2e6
This opens an OpenBSD-mirabile (aka MirBSD) repository. ### MirBSD is: # Copyright (c) 1982-2003 by Thorsten "mirabile" Glaser <x86@ePost.de> # Copyright © 1968-2003 The authors of And contributors to UNIX®, the # C Language, BSD/Berkeley Unix; 386BSD, NetBSD 1.1 and OpenBSD. # # Anyone who obtained a copy of this work is hereby permitted to freely use, # distribute, modify, merge, sublicence, give away or sell it as long as the # authors are given due credit and the following notice is retained: # # This work is provided "as is", with no explicit or implicit warranty what- # soever. Use it only at your own risk. In no event may an author or contri- # butor be held liable for any damage, directly or indirectly, that origina- # ted through or is caused by creation or modification of this work. MirBSD is my private tree. MirBSD does not differ very much from OpenBSD and intentionally tracks OpenBSD. That's why it _is_ OpenBSD, just not the official one. It's like with DarrenBSD. At time of this writing, no advertising for MirBSD must be done, because the advertising clause has not yet been sorted out. http://templeofhate.com/tglaser/MirBSD/index.php
198 lines
9.3 KiB
Plaintext
198 lines
9.3 KiB
Plaintext
$OpenBSD: README,v 1.10 2003/03/10 03:48:16 david Exp $
|
|
|
|
Last updated Jul '99 for pdksh-5.2.14.
|
|
(check ftp://ftp.cs.mun.ca:/pub/pdksh/ or
|
|
http://www.cs.mun.ca/~michael/pdksh/ for new versions/patches)
|
|
|
|
PD-ksh is a mostly complete AT&T ksh look-alike (see NOTES file for a list
|
|
of things not supported). Work is mostly finished to make it fully
|
|
compatible with both POSIX and AT&T ksh (when the two don't conflict).
|
|
|
|
Since pdksh is free and compiles and runs on most common unix systems, it
|
|
is very useful in creating a consistent user interface across multiple
|
|
machines. For example, in the CS dept. of MUN, pdksh is installed on a
|
|
variety of machines including Suns, HPs, DecStations, pcs running Linux,
|
|
etc., and is the login shell of ~5200 users.
|
|
|
|
PDksh is currently being maintained by Michael Rendell (michael@cs.mun.ca),
|
|
who took over from Simon J. Gerraty (sjg@zen.void.oz.au) at the later's
|
|
suggestion. A short list of things that have been added since the last
|
|
public pdksh release (4.9) are auto-configuration, arrays, $(( .. )),
|
|
[[ .. ]], variable attributes, co-processes, extended file globbing,
|
|
many POSIXisms and many bug fixes. See the NEWS and ChangeLog files for
|
|
other features added and bugs fixed.
|
|
|
|
Note that pdksh is provided AS IS, with NO WARRANTY, either expressed or
|
|
implied. Also note that although the bulk of the code in pdksh is in the
|
|
public domain, some files are copyrighten (but freely distributable) and
|
|
subject to certain conditions (eg, don't remove copyright, document any
|
|
changes, etc.). See the LEGAL file for details.
|
|
|
|
If you would like to be notified via email of new releases as they become
|
|
available, send mail to pdksh-request@cs.mun.ca with subject
|
|
"send release notifications" (or "don't send release notifications" to stop
|
|
them).
|
|
|
|
|
|
Files of interest:
|
|
NEWS short list of noticeable changes in various versions.
|
|
CONTRIBUTORS short history of pdksh, people who contributed, etc.
|
|
NOTES lists of known bugs in pdksh, at&t ksh, and posix.
|
|
PROJECTS list of things that need to be done in pdksh.
|
|
BUG-REPORTS list of recently reported bugs that have been fixed
|
|
and all reported bugs that haven't been fixed.
|
|
LEGAL A file detailing legal issues concerning pdksh.
|
|
etc/* system profile and kshrc files used by Simon J. Gerraty.
|
|
misc/README* readme files from previous versions.
|
|
misc/Changes* changelog files from previous versions.
|
|
os2/* files and info needed to compile ksh on os/2.
|
|
tests/* pdksh's regression testing system.
|
|
|
|
|
|
Compiling/Installing:
|
|
|
|
The quick way:
|
|
./configure
|
|
make
|
|
make check # optional
|
|
make install # will install /usr/local/bin/ksh
|
|
# and /usr/local/man/man1/ksh.1
|
|
[add path-to-installed-pdksh to /etc/shells]
|
|
|
|
The more detailed description:
|
|
* run "configure --help | your-favorite-pager" and look at the
|
|
--enable-* and --disable-* options (they are at the end).
|
|
Select any you options you wish to enable/disable
|
|
(most people can skip this step).
|
|
* run configure: this is a GNU autoconf configure script that will generate
|
|
a Makefile and a config.h. Some of the useful options to configure are:
|
|
--prefix=PATH indicates the directory tree under which the binary
|
|
and man page are installed (ie, PATH/bin/ksh and
|
|
PATH/man/man1/ksh.1).
|
|
The default prefix is /usr/local.
|
|
--exec-prefix=PATH overrides --prefix for machine dependent files
|
|
(ie, the ksh binary)
|
|
--program-prefix=pd install binary and man page as pdksh and pdksh.1
|
|
--verbose show what is being defined as script runs
|
|
Note that you don't have to build in the source directory. To build
|
|
in a separate directory, do something like:
|
|
$ mkdir objs
|
|
$ cd objs
|
|
$ ../configure --verbose
|
|
....
|
|
$ make
|
|
See the file INSTALL for a more complete description of configure and its
|
|
generic options (ksh specific options are documented in the --help output)
|
|
* miscellaneous configuration notes:
|
|
* If your make doesn't understand VPATH, you must compile in
|
|
the source directory.
|
|
* On DecStations, MIPS and SONY machines with older C compilers that
|
|
can't handle "int * volatile x", you should use gcc or turn off
|
|
optimization. The problem is configure defines volatile to nothing
|
|
since the compiler can't handle it properly, but the compiler does
|
|
optimizations that the volatile is meant to prevent. So. Use gcc.
|
|
* On MIPS RISC/os 5.0 systems, sysv environment, <signal.h> is
|
|
messed up - it defines sigset_t, but not any of the rest of
|
|
the posix signals (the sigset_t typedef should be in the
|
|
ifdef KERNEL section) - also doesn't have waitpid() or wait3().
|
|
Things compile up ok in the svr4 environment, but it dumps core
|
|
in __start (perhaps our system doesn't have the full svr4
|
|
environ?). Try compiling in the bsd43 environ instead (still not
|
|
perfect - see BUG-REPORTS file), using gcc - cc has problems with
|
|
macro expansions in the argument of a macro (in this case, the ARGS
|
|
macro).
|
|
* On TitanOS (Stardent/Titan), use `CC="cc -43" configure ...'.
|
|
When configure finishes, edit config.h, undef HAVE_DIRENT_H and
|
|
define HAVE_SYS_DIR_H (the dirent.h header file is broken).
|
|
* On Linux (red hat distribution), check that /dev/tty has mode 0666
|
|
(not mode 0644). If it has the wrong permissions, ksh will print
|
|
warnings about not being able to do job control.
|
|
* on NeXT machines (3.2, probably other releases), the siglist.out file
|
|
won't be generated correctly if you try to use the system's compiler
|
|
(it has a broken cc -E and strange header files). There are two
|
|
ways to make it work:
|
|
1) if you have gcc, use it (for everything). Alternatively,
|
|
force configure to use it for CPP, i.e., use
|
|
CPP="gcc -E" configure ...
|
|
2) Force configure to use some extra CPPFLAGS, using
|
|
CPPFLAGS="XXX" configure ...
|
|
where XXX is obtained from running "cc -v YYY.c" on some
|
|
C file. Look at the options passed to cpp (there are lots
|
|
of them...) and replace the XXX above with them.
|
|
Make sure you do a "make distclean" (or "rm config.cache") if
|
|
you re-run configure with a difference CPP or CPPFLAGS.
|
|
Also note that if you are building multiple arch binaries, you
|
|
will have to specify both CC and CPP.
|
|
* run make: everything should compile and link without problems.
|
|
* run make check: this fires up a perl script that checks for some known
|
|
and some fixed bugs. The script prints pass/fail for tests it expected
|
|
to pass/fail, and PASS/FAIL for tests it expected to fail/pass. If you
|
|
don't have perl, or if your perl doesn't work (most common problem is
|
|
the .ph header files are missing or broken), you can run
|
|
ENV= path-to-pdksh-executable misc/Bugs path-to-pdksh-executable
|
|
instead.
|
|
* run make install: this installs ksh (in /usr/local/bin/ksh by default,
|
|
or where ever you told configure to put things).
|
|
* add path-to-installed-pdksh to /etc/shells if it's not already there.
|
|
This is only needed if you intend to use pdksh as a login shell (things
|
|
like ftp won't allow users to connect in if their shell isn't in this
|
|
file).
|
|
|
|
The following is a list of machines that pdksh is reported to work on:
|
|
-/PC Linux 1.x,2.x
|
|
-/PC NetBSD 0.9a
|
|
-/PC BSDI 1.1
|
|
-/PC FreeBSD 2.x, 3.x
|
|
-/PC OpenBSD
|
|
-/PC Interactive/Sunsoft 3.0.1 and 4.1 (note that problems have been
|
|
reported with isc3.2 - see the BUG-REPORTS file)
|
|
-/PC OS/2
|
|
Commodore/Amiga NetBSD 1.0
|
|
Dec/alpha OSF/1 v2.x, v3.x
|
|
Dec/alpha NetBSD 1.1B
|
|
Dec/pmax Ultrix 4.2
|
|
Dec/vax Ultrix 2.2 (not tested recently :-))
|
|
Dec/vax 4.3BSD+NFS (MtXinu) (not tested recently :-))
|
|
HP/pa HP-UX 9.01
|
|
IBM/RS/6000 AIX 3.2.5
|
|
MIPS/m120 RISC/os 5.0 (bsd43 environ)
|
|
NeXT NeXTStep 3.2
|
|
SGI/IRIX 6.2
|
|
Sun/sun4 SunOS 4.1.3, 4.1.4
|
|
Sun/sun4 Solaris 2.x
|
|
Sun/sun386i SunOS 4.0.2
|
|
Sun/sun3 SunOS 4.0.3, 4.1.1_U1
|
|
Stardent/TitanOS 4.2
|
|
|
|
|
|
Newer versions of pdksh may be available from
|
|
ftp://ftp.cs.mun.ca:/pub/pdksh/
|
|
you may want to check for one if you run into any problems, as the problem may
|
|
already be fixed (you can get new release notifications automatically - see
|
|
above). The file pdksh-unstable-XXX.tar.gz has the very latest version which
|
|
may not compile (it is generated automatically when changes are detected
|
|
in the main source repository) - it is for those who want to follow
|
|
changes as they are made.
|
|
|
|
You can send bug reports, fixes, and enhancements to pdksh@cs.mun.ca (please
|
|
don't assume I will see bug reports that are posted to some newsgroup or
|
|
mailing list - I probably won't).
|
|
If you are reporting a bug (with or without a fix), please include
|
|
* the version of pdksh you are using (see version.c, or, if you are
|
|
running pdksh, try echo $KSH_VERSION),
|
|
* the machine, operating system and compiler you are using,
|
|
* and a description of how to repeat the bug (a small shell
|
|
script that demonstrates the bug is best).
|
|
as well as the following, if relevant (if you aren't sure, include them)
|
|
* what options you are using (both configure options and set -o options)
|
|
* the output of configure, with the verbose flag
|
|
(eg, make distclean; ./configure --verbose)
|
|
* the contents of config.log (this is created by the configure script)
|
|
* if you are using gcc (the GNU C compiler), which version it is.
|
|
|
|
BTW, THE MOST FREQUENTLY REPORTED BUG IS
|
|
echo hi | read a; echo $a # Does not print hi
|
|
I'm aware of this and there is no need to report it.
|
|
|
|
Michael Rendell, michael@cs.mun.ca
|