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/hdcor your specific CD-ROM drive) and append the kernel parametersrootfstype=iso9660 ramdisksize=4096. - The installation script
install.shaccepts an argument (with the same syntax asmke2fs) 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 throughproc/net/dev,/proc/net/arp,/proc/net/raw,/proc/net/route,/proc/net/tcpand/proc/net/udpwhile 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 flaggingneed_reschedon 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>/statfile. - 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 ofaddrlenif 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 thani->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 computingblksize_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_PERCENTAGEconfiguration 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.ext2and 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.
