Fork me on GitHub
Fiwix symbol
Welcome to the Fiwix project
Your small UNIX-like kernel

News

15-Nov-2026

Welcome to FiwixOS 3.6

FiwixOS 3.6 is a completely free, open source, UNIX-like hobby operating system based on the Fiwix kernel. This is a true self-hosting operating system, which means that all packages supplied (including the kernel) have been compiled natively and no other operating system was used in the process.

All binaries are linked statically and are built to use pure 80386 code. This is intended to make sure that FiwixOS 3.6 will run in very old hardware.

Hopefully, this will be the last version to use a hybrid setup with two C libraries: Newlib and musl. musl is used only to compile programs that require native network support. It's expected that the next version of FiwixOS will have transitioned entirely to musl.

Hardware Requirements

FiwixOS 3.6 runs only in the 32-bit i386 architecture with the following minimal requirements:
  • Standard IBM PC-AT architecture.
  • CPU: 80386 or compatible (with floating-point processor).
  • RAM: 4MiB (at least 16MiB are needed for the installation).
  • ATA Hard disk: 1GiB (minimal installation requires only ~200MiB).
  • ATAPI CD-ROM drive.

New in FiwixOS 3.6

This section provides an overview of the major highlights in this release.

  • Fiwix kernel version 1.8.0 (see detailed changes below).
  • Newlib C library version 4.6.0.
  • Added networking support by porting lwIP (v2.2.1) into the kernel's build (BETA).
  • Added basic network-related Linux ioctl()s.
  • Added Realtek RTL8139 network driver.
  • Added generic PCI Bus-Master DMA support on ATA disks.
  • Improvements and bug fixes in the system environment.

My special thanks to Samuel Tyler for his contribution to network support.
Also thanks to Nina Kalinina as a valuable contributor.

Installation-Related Notes

This section outlines those issues that are related to the installation procedure.

  • The installation procedure cannot be started from the floppy disk; it must be initiated via the CD-ROM. However, if you are using an older PC that cannot boot from a CD-ROM, you can boot from the floppy disk and use the CD-ROM as the root filesystem to continue. To do this, boot from the floppy disk and modify the kernel command-line in the GRUB menu: change the root device to the CD-ROM (e.g: root=/dev/hdc or your specific CD-ROM drive) and append the kernel parameters rootfstype=iso9660 ramdisksize=4096.
  • The installation script install.sh accepts an argument (with the same syntax as mke2fs) to specify the default block size for all the filesystems except /boot (e.g: ./install.sh "-b 4096").

Package Changes

This is a list of packages that have changed since the previous release:

  • byacc-20260126.
  • ddrescue-1.30.
  • dos2unix-7.5.7.
  • e2fsprogs-1.41.14.
  • ed-1.22.6.
  • file-5.48.
  • global-6.6.15.
  • groff-1.24.2.
  • gzip-1.15.
  • jpeg-10.
  • lcms2-2.19.1.
  • less-692.
  • libffi-3.8.0.
  • libiconv-1.19.
  • libpng-1.6.59.
  • libtool-2.6.2.
  • lua-5.5.1.
  • libxcrypt-4.5.2.
  • lzip-1.26.
  • moe-1.16.
  • mpc-1.4.1.
  • musl-gcc-1.1.24.
  • nano-8.7.1.
  • nasm-3.02.
  • newlib-4.6.0.20260123.
  • pciutils-3.15.0.
  • perl-5.26.3.
  • readline-8.3.
  • sysvinit-2.88dsf.
  • tiff-4.7.2.
  • tree-2.3.2.
  • units-2.27.
  • vttest-20251205.
  • wdiff-1.2.3.
  • which-2.25.
  • zlib-1.3.2.

This is a list of packages new in this version:

  • bison-3.8.2.
  • busybox-networking-1.01.
    • Busybox version with networking applets only.
  • dhcp-2.0pl5
    • A DHCP (Dynamic Host Configuration Protocol) server and client.
  • dosbox-0.74.3
    • DOSBox, an x86 emulator with DOS.
      (special thanks to Nina Kalinina).
  • inetutils-1.9.4
    • The GNU Networking Utilities.
  • mtools-4.0.49
    • Collection of utilities to access MS-DOS disks without mounting them.
      (special thanks to Nina Kalinina).
  • ncftp-3.3.0
    • Improved console FTP client.
  • net-tools-2.10
    • Basic networking tools.

This is a list of packages removed in this version:

Kernel changes

The following is a complete list of changes.

1.8.0 - 15-Nov-2026
===================
- Added networking support by porting lwIP into the kernel's build. [#36]
- Added support for basic Linux socket ioctls.
- Added support for retrieving network information through proc/net/dev,
  /proc/net/arp, /proc/net/raw, /proc/net/route, /proc/net/tcp and
  /proc/net/udp while maintaining Linux compatibility.
- Added Realtek RTL8139 network driver.
- Added generic PCI Bus-Master DMA support on ATA disks.
- Added support for tilde dead key. [#102]
- Added the 'flags' entry in the 'kernel_params' structure to group all toggle-
  type parameters.
- Added the new kernel parameter 'ide_nodma' to disable DMA in all ATA drives.
- Added support to be able to right-justify strings in printk().
- Added support for some new functions in lib/string.c.
- Added reclaim_inodes(), which is called after reclaim_buffers() to free memory
  allocated for inodes.
- Added the procfs_readdir64() method to support sys_getdents64() on procfs.
- Changed the 'ps2_noreset' to a toggle-type parameter.
- Changed the way how device drivers find PCI-type devices.
- Changed the serial device driver arrays to use dynamic allocation and fixed
  some bugs.
- The function page_not_present() now returns 1 if it cannot find a stack region
  in the vma_table (this is a testing change).
- Moved ipc_init() and net_init() initialization into kswpad() to make sure the
  'current' process stucture is completely setup.
- Removed the file CREDITS because the LICENSE file already contains the list of
  contributors.
- Removed the configuration option CONFIG_LAZY_USER_ADDR_CHECK.
- Reimplemented atoi() to rely on strtol().
- Increased the amount of padding up to 255 characters in do_printk().
- Increased from 1024 to PAGE_SIZE (4096) the buffer used in printk(), sprintk()
  and snprintk().
- Improved the efficiency in append_packet_to_queue().
- Improved pipe access by locking the pipe's inode instead of using a global
  resource lock.
- Fixed the ATA disk initialitzation to reduce the number of messages like
  'unexpected interrupt'.
- Fixed the DMA functionality in ATA disks to use UDMA since the support for the
  Multiword DMA is not always assured in all cases.
- Fixed ata_hd_init() to preserve the current value of Status in Bus-Master
  register while setting DMA.
- Fixed ata_setup_dma() and ata_start_dma() to preserve the current register
  status before writing a new value.
- Fixed to save the BIOS Data Area (256 bytes) to prevent it from being
  clobbered by the early use of the first memory page.
- Fixed dump_registers() to be able to show the registres on an early kernel
  panic.
- Fixed wakeup() to avoid flagging need_resched on every iteration and thus
  saving extra context switchings.
- Fixed ps2_init() to no use anymore the command 0xCA (to get the current
  interface) as it is not an standardized command.
- Fixed the start_code and end_code values in /proc/<PID>/stat file.
- Fixed a bad vma address calculation in verify_address().
- Fixed verify_address() to not verify pointer addresses when calling system
  calls from the kernel.
- Fixed strncmp() to actually compare only the first (at most) n bytes of str1
  and str2.
- Fixed the inode count in mmap() functions.
- Fixed a possible infinite loop in do_munmap().
- Fixed some calculations to use the pointer size instead of the data type,
  improving code portability. [#113]
- Fixed kmalloc() and kfree() to protect bl_malloc() and bl_free() to avoid
  corruption when allocate/free memory in interrupt context.
- Fixed mutex_lock() and mutex_unlock() to avoid races and memory corruption.
- Fixed remove_packet_from_queue() to avoid races and memory corruption.
- Fixed recvfrom() to pass the value of addrlen if it was supplied by the
  caller.
- Fixed timer counter underflows in gettimeoffset() that caused it to return
  earlier timestamps.
- Fixed sys_gettimeofday() to carry over to seconds when microseconds value
  overflows.
- Fixed a kernel panic when trying to show argv and envp values from a zombie
  process.
- Fixed a potential use-after-free in ext2_followlink() and minix_followlink().
- Fixed a potential out-of-range of OPEN_MAX in sys_dup2().
- Fixed a potential out-of-range of NSIG in sys_kill(), sys_sigaction() and
  sys_signal().
- Fixed a missing argument check in the tty ioctl TIOCINQ that could have led
  to local privilege escalation.
- Fixed late argument check in tty ioctl TIOCLINUX that could have led to local
  privilege escalation.
- Fixed bread_page() to revert the changes in the page hash table if kmalloc()
  or bmap() fails.
- Fixed write_page() to make sure it cannot underflow if offset is greater than
  i->i_size.
- Fixed do_mmap() to avoid an overflow in the comparison.
- Fixed del_inode_from_pool() and del_buffer_from_pool() to effectively remove
  the last inode and buffer in the pool.
- Fixed bread() to avoid leaving the buffer permanently locked if get_device()
  fails.
- Fixed do_sched() to protect process iteration against possible corruption.
- Fixed sendto() to relay to send() when the last two arguments are zero.
- Fixed data_proc_pid_fd() to display the major/minor pair as zeros for sockets
  and pipes.
- Fixed ext2_readdir() and ext2_readdir64() to allow an entry that fits exactly
  the caller's buffer, also check iget() before dereferencing its result.
- Fixed ext2_ialloc(), ext2_ifree(), ext2_balloc() and ext2_bfree() to reject
  an already-set/clear bit instead of returning it as allocated/freed.
- Fixed ext2_bfree() to validate correctly block numbers.
- Fixed ext2_file_write() to free the request on bmap() failure, also to
  preserve successful bytes when write later fails.
- Fixed find_first_free_dir_entry() to use name_len instead of strlen() when
  finding free space in a directory.
- Fixed ext2_rename() to avoid a possible double unlock an inode.
- Fixed ext2_followlink() to use i_size instead of strlen() to get the symlink
  length, also changed to signed-type for the result of parse_namei().
- Fixed kbdflushd() to clear the BUFFER_LOCKED flag if an inconsistency was
  found in the dirty list.
- Fixed blk_dev_read() and blk_dev_write() to validate the device's configured
  block size before computing blksize_bits.
- Fixed blk_dev_read() and blk_dev_write() to return the current byte count on
  an I/O failure.
- Fixed flock_release_inode() to avoid a use-after-free case.
- Fixed add_mount_point() to initialize the new entry before adding it to mount
  table.
- Fixed register_filesystem() to undo the changes if kern_mount() returns error.
- Fixed how data_proc_partitions() represents the minor number for block
  devices.
- Fixed an infinite loop when there are no more buffers to reclaim. Messages are
  now displayed again, and all inodes are reclaimed in that case.
- Small fixes and improvements, code cleanup and cosmetic changes.

Known Issues

This is a list of known issues pending to be resolved:

  • There is a known bug that prevents FiwixOS from installing on systems with 64MiB of memory or less when the INODE_PERCENTAGE configuration option is set below 5. To keep installation working on these memory-constrained systems, I’ll leave the option set to 5 while I investigate the cause.
  • There are other bugs throughout the system. Some are harmless, while others are annoying; a few can occasionally cause a kernel panic.
  • Regarding the filesystem, file corruption cases are really low but not 100% free. I recommend to make periodic filesystem checks with fsck.ext2 and backups, so you can recover from a serious situation.
  • Networking support is experimental. It mostly works, but you may encounter a kernel PANIC.

Definitely this code needs more eyeballs to help to catch all these bugs.


First   Previous   Next   Last