ibara/ oksh

(oksh-6.8.1) 4 months ago

openbsd

Shell

unix

bsd

View on GitHub

Need help with oksh?

Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

ibara

134 Stars

18 Forks

212 Commits

4 Opened issues

Description

Portable OpenBSD ksh, based on the Public Domain Korn Shell (pdksh).

Services available

Need anything else?

Contributors list

Readme

oksh

Name: oksh
Brand: oksh
SKU: //ibara/oksh
Rating: 2.085 (134 reviews)

Portable OpenBSD

ksh(1)

Why?

Because all operating systems deserve a good shell.

Unlike other ports of OpenBSD ksh, this port is entirely self-contained and aims to be maximally portable across operating systems and C compilers. We are always looking for new combinations to add support for.

Supported systems

oksh

is known to run on the following Operating Systems: * OpenBSD * FreeBSD * DragonFly BSD * NetBSD * HardenedBSD * SoloBSD (as the default shell) * Mac OS X * Linux (glibc and musl) * Cygwin * Android (via Termux) * AIX (with major thanks to @tssva and @NattyNarwhal) * IBM i PASE * Solaris * Illumos * midipix * WSL * WSL2 * Unixware 7 * Haiku * HP-UX (only gcc tested)

Running on a system not listed here? Add it and send a pull request!

Believed working

We believe that

oksh

will work on the following platforms, but testing is needed. Help is greatly appreciated and encouraged! * Irix

Supported compilers

oksh

is known to build with the following C compilers: * clang (https://llvm.org/) * gcc (https://gcc.gnu.org/) * pcc (http://pcc.ludd.ltu.se/) * cparser (https://pp.ipd.kit.edu/firm/) * xlc (https://www.ibm.com/us-en/marketplace/ibm-c-and-c-plus-plus-compiler-family) * Sun Studio compiler (https://www.oracle.com/technetwork/server-storage/developerstudio/overview/index.html) * lacc (https://github.com/larmel/lacc) * Optimizing C Compilation System (CCS) 4.2 03/27/14 (uw714mp5.bl4s) * Tiny C Compiler (https://bellard.org/tcc/) * CompCert (https://compcert.org/) * Nils Weller's C compiler (http://nwcc.sourceforge.net/)

Building with a compiler not listed here? Add it and send a pull request!

Packages

oksh

is included in some package systems.

In addition, there are some unofficial packages: * Ubuntu PPA * Homebrew * Debian

Using a package not listed here? Add it and send a pull request!

Dependencies

A C99 compiler is the easiest way to ensure that

oksh

will build correctly. Please see the list of C compilers above for a list of known working compilers.

Though not required, the

ncurses

library will be used for screen clearing routines if the library is found during the

configure

stage. This can be turned off by the user by passing the

--disable-curses

flag to

configure

configure

script that produces a

POSIX

Makefile

is provided to ease building and installation and can be run by:

$ ./configure
$ make && sudo make install

Cross compiling

Cross compiling can be achieved by running

configure

as follows:

CC=/path/to/cross/cc CFLAGS="any needed cflags" LDFLAGS="any needed ldflags" ./configure --no-thanks

This will skip all

configure

checks and write out a generic

Makefile

and

pconfig.h

with nearly no options turned on. If using a cross gcc or clang, this very well may just work (with all compat compiled in). You can edit these files to reflect your system before running

make

All environment variables and configure flags are respected when using

--no-thanks

. Further specifying

--no-link

after

--no-thanks

will only compile the source files into object files, to be transfered onto the target machine and linked there.

The

--no-thanks

flag can also be used to compile a native

oksh

with all the compatibility functions compiled in, rather than relying on the system's version of those functions.

Submitting patches

Patches that add new platforms and improve support for existing platforms are always welcome.

Patches that cause

oksh

to deviate from upstream OpenBSD ksh behavior are better suited to be sent to the OpenBSD [email protected] mailing list. Please make sure to test your patch on an OpenBSD machine first before submitting it to [email protected] I will sync with the upstream OpenBSD code once your patch is accepted. If you'd like to open an issue here to track progress of your patch on [email protected], that's fine.

License

The main Korn shell files are public domain (see

LEGAL

). Portability files are BSD or ISC licensed; see individual file headers for details.

Get a tarball

See releases tab. The latest release is oksh-6.8.1, which matches the ksh(1) from OpenBSD 6.8.