Wiki releases:3.2.0:usersguide

releases:3.2.0:usersguide:apachephp

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T14:03:36+0200

Apache and PHP (tested for Minix3 version 3.1.4-pre) Using packman Install Apache and PHP via packman. Additional steps Currently, installation doesn't have a php.ini file and httpd.conf is incomplete. Copy file to /usr/local/lib/gcc/php.ini

releases:3.2.0:usersguide:apic

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T13:53:53+0200

Stale page The contents of this page must be revised to reflect the current state of MINIX3. APIC mode APIC is a successor to the legacy PIC. The main advantage is that together with IO APIC controllers it enables the system to use much more IRQ lines than the 16 legacy (E)ISA IRQs and thus possible much less IRQ sharing. Using local APICs is a requirement for multi-processor systems.

releases:3.2.0:usersguide:bootingovernetworkusingpxe

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T13:56:36+0200

Introduction It is possible to boot the minix 3 usb image over network using pxelinux and memdisk. This makes use of the PXE protocol supported in some network cards. The network card loads its boot files over network and boot the PC from these files.

releases:3.2.0:usersguide:bootmonitor

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T14:04:55+0200

The MINIX boot monitor has been replaced for version 3.2.0 with NetBSD boot monitor. The MINIX 3 Boot Monitor This page describes the MINIX 3 boot monitor. To get a summary of what the boot monitor can do, while in it, you can type: help

releases:3.2.0:usersguide:commandlineinterface

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Command Line Interface Introduction A command-line interface (CLI) is a mechanism for interacting with a computer operating system or software by typing commands to perform specific tasks. This text-only interface contrasts with the use of a mouse pointer with a

releases:3.2.0:usersguide:diskpartitions

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T14:07:16+0200

Disk Partitions Introduction to Partitions When the IBM PC was first launched, it came with a simple disk operating system called MS-DOS, provided by Microsoft. IBM made a decision that a PC might ultimately have up to four operating systems installed at the same time. Each operating system would have its own portion of the disk, called a

releases:3.2.0:usersguide:doinginstallation

Anonymous (anonymous@undisclosed.example.com) — 2014-11-17T14:12:12+0200

Installing MINIX 3 This page describes the process of installing MINIX 3. If you want to run MINIX 3 on a virtual machine instead of natively, see the installation page for your VM of choice before reading this page: * Running MINIX 3 on VMware * Running MINIX 3 on Qemu (and KVM) * Running MINIX 3 on Bochs * Running MINIX 3 on Parallels * Running MINIX 3 on VirtualBox * Running MINIX 3 on Microsoft VirtualPC 2007

releases:3.2.0:usersguide:emailapps

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Email Applications Pine can be installed via packman. With 3.1.8 and later use pkgsrc. See the developer guide of pkgsrc.

releases:3.2.0:usersguide:filetransfer

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

File Transfer There are several programs that can be used to transfer files between machines. Some of them come with MINIX by default: * ftp * rcp * fetch * urlget (download only) Additionally, the following programs can be installed via packman:

releases:3.2.0:usersguide:gnudevelopmenttools

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Note: Packman is outdated. Since 3.1.8 you should use pkgin and pkgsrc. See installing and developing with pkgsrc. They have more packages than mentioned below. GNU Development Tools You can install many of the GNU development tools on MINIX. GCC (GNU Compiler Suite)

releases:3.2.0:usersguide:gnuutilities

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Using the GNU utilities You can install many of the Linux (read GNU) userland utilities on MINIX. Via pkgin, you can install: * BASH shell * GNU coreutils * GNU awk * GNU grep * GNU sed * GNU diffutils * GNU less The pkgin tool will install the software to

releases:3.2.0:usersguide:hardwarerequirements

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

MINIX 3 Hardware Requirements CPU Requirements MINIX 3 runs on Pentium-class hardware or later. Other Pentium-compatible CPUs are also supported. MINIX 3 does not currently support 64-bit x86. Memory The standard installation needs 28 MB of RAM as to release 3.1.8, but older versions have been be squeezed into 8

releases:3.2.0:usersguide:harmlessdiagnostics

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T13:54:58+0200

Harmless Diagnostics This page describes various diagnostics produced by the networking and the PCI code that can be safely ignored. dp8390: strange, got SYN_ALARM The dp8390 driver got a message about an expired timer. But the driver does not use any timers. This is probably a small bug in the timer library. The message can be safely ignored (but it is better to fix the library).

releases:3.2.0:usersguide:installationoptimizations

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Optimizations This page gives some hints and optimizations you can make to tune your MINIX 3 system to match your requirements. Increase the File System buffer cache If you have a large memory, you may also wish to increase the size of the file system buffer cache. To do this, change the value of the constant

releases:3.2.0:usersguide:installationtroubleshooting

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Installation Troubleshooting Using two disks If your computer has two hard disks on the IDE controller and you are installing MINIX 3 to the second one, sometimes there can be a problem booting. This problem occurs if the second disk does not have a correct boot program in the MBR (Master Boot Record). To solve this problem, boot MINIX 3 from the CD-ROM, log in as root, and type:

releases:3.2.0:usersguide:installingbinarypackages

Anonymous (anonymous@undisclosed.example.com) — 2017-12-23T20:05:35+0200

Installing Binary Packages pkgin As of release 3.1.8, pkgin is the binary package manager for Minix 3. This page describes how to use pkgin. Note, additional packages can built from source. See Installing Source Packages for details. pkgin Usage First, you will need to fetch the package list and populate the package database:

releases:3.2.0:usersguide:installingbinarypackagesonolderreleases

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Installing Binary Packages (Release 3.1.7 and below) Minix 3.1.7 and below provides packman to manage binary packages. Newer releases uses pkgin and pkgsrc. See InstallingBinaryPackages for the details. Packman To install new packages, you will use the packman program. You must run packman as

releases:3.2.0:usersguide:installingsourcepackages

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Installing Source Packages pkgsrc As of release 3.1.8, pkgsrc is used to build third party software on Minix3. This page describes how to use pkgsrc. Before diving in, you should be aware that the Minix 3 project provides precompiled binary packages for many third party applications. This can save a lot of time. See

releases:3.2.0:usersguide:introductiontox

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Introduction to X X (also called X11 or more formally, the X Window System) is the standard windowing system for most UNIX systems. It is supported by MINIX 3, but not part of the basic distribution (due to its great size). To use X, you must first fetch and install it. See

releases:3.2.0:usersguide:introtosysadmin

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Introduction to System Administration Congratulations on installing MINIX 3. Now you have to learn how to administer a MINIX 3 system. Fortunately, we have some help for you in the form of documentation. This page contains some things all newbie superusers should know.

releases:3.2.0:usersguide:lancefix

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T14:40:52+0200

Lance Driver Fix This fix is only necessary for MINIX versions below 3.1.4. In MINIX 3.1.3, the AMD Lance NIC device driver does not work. There are two reasons for that problem: * The lance driver needs to be loaded within the first 16MiB of memory, for DMA purposes. The servers loaded before the lance driver add up to more than 16MiB, so that the lance driver falls outside that area.

releases:3.2.0:usersguide:managinguseraccounts

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T13:51:19+0200

Managing User Accounts You'll need to be the root user to do any of the following. Adding a New Group To add a new user group to the system you need to add an entry to the /etc/group file. The entry format is: “:*::” The group ids already used by MINIX are 0-11, 26, and 99.

releases:3.2.0:usersguide:manpagesforadmins

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

MAN pages for administrators add_route(8) - configure IP routing. adduser(8) - add a new user to the system backup(8) - backup files badblocks(8) - put a list of bad blocks in a file boot(8) - from power on to the login prompt checkhier(8) - check the directory hierarchy chown(8) - change owner cleantmp(8) - clean out a tmp dir config(8) - configuring MINIX 3 tasks and servers cron(8) - clock daemon dhcpd(8) - dynamic host configuration protocol daemon dosminix, mkfile (8)…

releases:3.2.0:usersguide:multipleoperatingsystems

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Running Multiple Operating Systems Booting MINIX 3 Directly MINIX 3 can coexist on a hard disk with Windows or Linux. The hard part is figuring out how to choose which OS to boot. Here are a few hints: * Using the MINIX boot monitor to start other operating systems (May be outdated) Using GRUB 2 to boot MINIX 3 GRUB 2 stores its configuration in a file called

releases:3.2.0:usersguide:networkconfiguration

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T13:58:03+0200

Network Configuration MINIX supports several Ethernet chips for networking over LAN, ADSL, and cable. These include Intel Pro/100, RealTek 8029 and 8139, AMD LANCE, and several 3Com chips. During setup you will be asked which Ethernet chip you have, if any.

releases:3.2.0:usersguide:postinstallation

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Post Installation Set the Root Password You should set a password for the root account. Type: passwd Then enter the new password in the prompts (No characters or *'s will appear as you type your password but it IS being entered). Set the Timezone

releases:3.2.0:usersguide:runningonbochs

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Running MINIX 3 on Bochs This page describes the process of installing MINIX 3 on Bochs. Preliminaries Please install bochs. Bochs binaries can be downloaded from their webpage. If you're running a Linux distribution, you can install Bochs via the package manager.

releases:3.2.0:usersguide:runningonparallels

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T14:11:49+0200

Running MINIX 3 on Parallels This page describes the process of installing MINIX 3 on VirtualBox. Preliminaries Please install Parallels. Parallels binaries can be downloaded from their webpage. Virtual Machine Setup Before you install Minix 3, you will need to create a new virtual machine configuration. The VM configuration specifies the parameters of your Virtual machine, e.g., how much memory you want the VM to use, how big you want the virtual hard disk to be, etc.

releases:3.2.0:usersguide:runningonqemu

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Running MINIX 3 on QEMU and KVM This page describes the process of installing MINIX 3 on QEMU and KVM. Preliminaries Please install QEMU or KVM. QEMU and KVM sources can be downloaded from their webpage. If you're running a Linux distribution, you can install QEMU and KVM via the package manager.

releases:3.2.0:usersguide:runningonvirtualbox

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T14:48:14+0200

Running MINIX 3 on VirtualBox This page describes the process of installing MINIX 3 on VirtualBox. Preliminaries Please install VirtualBox. VirtualBox binaries can be downloaded from their webpage. If you're running a Linux distribution, you can install VirtualBox via the package manager.

releases:3.2.0:usersguide:runningonvirtualpc

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T13:49:36+0200

Running Minix 3 on Microsoft Virtual PC 2007 This page describes the process of installing MINIX 3 on Microsoft Virtual PC 2007. Preliminaries Installation of Microsoft VirtualPC 2007 on a windows machine. Virtual Machine Setup Before you install Minix 3, you will need to create a new virtual machine configuration. The VM configuration specifies the parameters of your Virtual machine, e.g., how much memory you want the VM to use, how big you want the virtual hard disk to be, etc.

releases:3.2.0:usersguide:runningonvmware

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T15:00:32+0200

Running Minix 3 on VMware This page describes the process of installing MINIX 3 on VMWare. Preliminaries Please install VMWare. VMWare binaries can be downloaded from their webpage. Virtual Machine Setup Before you install Minix 3, you will need to create a new virtual machine configuration. The VM configuration specifies the parameters of your Virtual machine, e.g., how much memory you want the VM to use, how big you want the virtual hard disk to be, etc.

releases:3.2.0:usersguide:serialconsoles

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Serial Consoles Introduction With a little configuration, it's possible to use a dumb terminal connected to a minix host. Alternatively, one could connect a PC to a minix host via a null-modem cable and run a terminal emulator program on the PC to act as a dumb terminal.

releases:3.2.0:usersguide:settingrootpasword

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Setting the Root Password By default, Minix 3 does not have a root password. That is an obvious security problem, especially if the system is being used for any serious purpose. So, you should set a root password, as soon as possible, unless you're just experimenting on an isolated machine.

releases:3.2.0:usersguide:settingupssh

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T14:26:02+0200

Setting Up SSH The following steps must be done as root. * Install OpenSSH pkgin install openssh * Customize settings Optionally, edit /usr/pkg/etc/ssh/sshd_config. * Start sshd reboot or sh /usr/pkg/etc/rc.d/sshd start Security keys will be created automatically.

releases:3.2.0:usersguide:shutdown

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Shutting Down the System You can shutdown the system by typing: shutdown You will be returned to the boot monitor. To power off the machine, you can enter: off Alternatively, if you do not wish to drop back to the boot monitor, you can enter:

releases:3.2.0:usersguide:start

Anonymous (anonymous@undisclosed.example.com) — 2014-11-14T14:43:32+0200

MINIX 3 Users Guide Table of Contents The Users Guide provides information on how to install and configure MINIX 3. If you're new to MINIX 3, you should start here. Part I: Getting Started * Introduction * Welcome to MINIX 3 * Installing MINIX 3 * Hardware Requirements *

releases:3.2.0:usersguide:usingsharedlibraries

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Shared Libraries State Ending with commit 53f94f8ed431, Minix has full shared libraries support, include runtime loading of shared objects by the runtime linker, ld.elf_so, i.e. dlopen() and friends. By default binaries are not linked dynamically yet, out of caution. This page describes the interaction with the base system and how to get started with building dynamically linked executables. Everyone is invited to test building dynamic binaries and test the resulting system. And also to help ge…

releases:3.2.0:usersguide:webbrowsers

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Web Browsers Currently, only text-mode browsers are supported under MINIX 3. You can install links or lynx via pkgin. See the Installing Binary Packages guide for details on installing software.

releases:3.2.0:usersguide:welcometominix

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Welcome to MINIX 3 MINIX 3 is a new open-source operating system designed to be highly reliable, flexible, and secure. It is loosely based somewhat on previous versions of MINIX, but is fundamentally different in many key ways. MINIX 1 and 2 were intended as teaching tools; MINIX 3 adds the new goal of being usable as a serious system on resource-limited and embedded computers and for applications requiring high reliability

releases:3.2.0:usersguide:windowmanagers

Anonymous (anonymous@undisclosed.example.com) — 2014-11-11T14:52:08+0200

Window Managers in MINIX In MINIX there are three window managers available: Tom's Window Manager, Joe's Window Manager and Equinox Desktop Environment. The first one, twm, is installed by default with the X.org package and the second and the third can be installed through the pkgin (tool to manage pkgsrc binary packages) utility.