How to program in C on FreeDOS |

How to program in C on FreeDOS

Programming in C on FreeDOS is very similar to C programming on Linux.

Woman sitting in front of her computer
Image credits : 
Ray Smith

Subscribe now

Get the highlights in your inbox every week.

When I first started using DOS, I enjoyed writing games and other interesting programs using BASIC, which DOS included. Much later, I learned the C programming language.

I immediately loved working in C! It was a straightforward programming language that gave me a ton of flexibility for writing useful programs. In fact, much of the FreeDOS core utilities are written in C and Assembly.

So it's probably not surprising that FreeDOS 1.3 RC4 includes a C compiler—along with other programming languages. The FreeDOS 1.3 RC4 LiveCD includes two C compilers—Bruce's C compiler (a simple C compiler) and the OpenWatcom C compiler. On the Bonus CD, you can also find DJGPP (a 32-bit C compiler based on GNU GCC) and the IA-16 port of GCC (requires a '386 or better CPU to compile, but the generated programs can run on low-end systems).

Programming in C on FreeDOS is basically the same as C programming on Linux, with two exceptions:

  1. You need to remain aware of how much memory you use. Linux allows programs to use lots of memory, but FreeDOS is more limited. Thus, DOS programs used one of four memory models (large, medium, compact, and small) depending on how much memory they needed.
  2. You can directly access the console. On Linux, you can create text-mode mode programs that draw to the terminal screen using a library like ncurses. But DOS allows programs to access the console and video hardware. This provides a great deal of flexibility in writing more interesting programs.

I like to write my C programs in the IA-16 port of GCC, or OpenWatcom, depending on what program I am working on. The OpenWatcom C compiler is easier to install since it's only a single package. That's why we provide OpenWatcom on the FreeDOS LiveCD, so you can install it automatically if you choose to do a "Full installation including applications and games" when you install FreeDOS 1.3 RC4. If you opted to install a "Plain DOS system," then you'll need to install the OpenWatcom C compiler afterward, using the FDIMPLES package manager.


installing OpenWatcom

Installing OpenWatcom on FreeDOS 1.3 RC4
(Jim Hall, CC-BY SA 4.0)

DOS C programming

You can find documentation and library guides on the OpenWatcom project website to learn all about the unique DOS C programming libraries provided by the OpenWatcom C compiler. To briefly describe a few of the most useful functions:

From conio.h:

  • int getch(void)—Get a single keystroke from the keyboard
  • int getche(void)—Get a single keystroke from the keyboard, and echo it

From graph.h:

  • _settextcolor(short color)—Sets the color when printing text
  • _setbkcolor(short color)—Sets the background color when printing text
  • _settextposition(short y, short x)—Move the cursor to row y and column x
  • _outtext(char _FAR *string)—Print a string directly to the screen, starting at the current cursor location

DOS only supports sixteen text colors and eight background colors. You can use the values 0 (Black) to 15 (Bright White) to specify the text colors, and 0 (Black) to 7 (White) for the background colors:

  • 0—Black
  • 1—Blue
  • 2—Green
  • 3—Cyan
  • 4—Red
  • 5—Magenta
  • 6—Brown
  • 7—White
  • 8—Bright Black
  • 9—Bright Blue
  • 10—Bright Green
  • 11—Bright Cyan
  • 12—Bright Red
  • 13—Bright Magenta
  • 14—Yellow
  • 15—Bright White

A fancy "Hello world" program

The first program many new developers learn to write is a program that just prints "Hello world" to the user. We can use the DOS "conio" and "graphics" libraries to make this a more interesting program and print "Hello world" in a rainbow of colors.

In this case, we'll iterate through each of the text colors, from 0 (Black) to 15 (Bright White). As we print each line, we'll indent the next line by one space. When we're done, we'll wait for the user to press any key, then we'll reset the screen and exit.

You can use any text editor to write your C source code. I like using a few different editors, including FreeDOS Edit and Freemacs, but more recently I've been using the FED editor because it provides syntax highlighting, making it easier to see keywords, strings, and variables in my program source code.


writing a simple C program

Writing a simple test program in C
(Jim Hall, CC-BY SA 4.0)

Before you can compile using OpenWatcom, you'll need to set up the DOS environment variables so OpenWatcom can find its support files. The OpenWatcom C compiler package includes a setup batch file that does this for you, as \DEVEL\OW\OWSETENV.BAT. Run this batch file to automatically set up your environment for OpenWatcom.

Once your environment is ready, you can use the OpenWatcom compiler to compile this "Hello world" program. I've saved my C source file as TEST.C, so I can type WCL TEST.C to compile and link the program into a DOS executable, called TEST.EXE. In the output messages from OpenWatcom, you can see that WCL actually calls the OpenWatcom C Compiler (WCC) to compile, and the OpenWatcom Linker (WLINK) to perform the object linking stage:


compiling with OpenWatcom

Compiling the test program with OpenWatcom
(Jim Hall, CC-BY SA 4.0)

OpenWatcom prints some extraneous output that may make it difficult to spot errors or warnings. To tell the compiler to suppress most of these extra messages, use the /Q ("Quiet") option when compiling:

If you don't see any error messages when compiling the C source file, you can now run your DOS program. This "Hello world" example is TEST.EXE. Enter TEST on the DOS command line to run the new program, and you should see this very pretty output:

C is a very efficient programming language that works well for writing programs on limited-resource systems like DOS. There's lots more that you can do by programming in C on DOS. If you're new to the C language, you can learn C yourself by following along in our Writing FreeDOS Programs in C self-paced ebook on the FreeDOS website, and the accompanying "how-to" video series on the FreeDOS YouTube channel.

Old UNIX computer

It looks like retro computing, but it's a modern OS you can use to get stuff done.
4 different color terminal windows with code

Armed with just two commands DIR and CD, you can navigate your FreeDOS system from the command line.
FreeDOS fish logo and command prompt on computer

If you're already familiar with the Linux command line, try these commands to help ease into FreeDOS.
Looking at a map for career journey

Environment variables are helpful in almost every command-line environment, including FreeDOS.
Tips and gears turning

Here's a helpful guide to batch files under FreeDOS.
Code going into a computer.

An overview of how your computer boots up and starts a simple operating system like FreeDOS.
Person using a laptop

Learn how to configure FreeDOS with FDCONFIG.SYS.
Package wrapped with brown paper and red bow

Get familiar with FDIMPLES, the FreeDOS package manager.
Person using a laptop

FreeDOS provides a user-friendly text editor called FreeDOS Edit.
FreeDOS fish logo and command prompt on computer

Here's how to set up your FreeDOS system manually without using the installer.
Woman programming

Mplayer is an open source media player that's usually found on Linux, Windows, Mac, and DOS.
Computer laptop in space

Many embedded systems today run on Linux. But once upon a time, embedded systems either ran on a custom, proprietary platform or ran on DOS.
Person typing on a 1980's computer

Why does text only come in this limited palette, and why does FreeDOS use those colors and shades, instead of some other colors? The answer, like many things in technology, is because of history.
Old UNIX computer

Edlin is a joy to use when I want to edit text the "old school" way.
Old UNIX computer

BASIC was my entry into computer programming. I haven't written BASIC code in years, but I'll always have a fondness for BASIC and GW-BASIC.
Typewriter in the grass

If you're already familiar with GNU Emacs, you should feel right at home in Freemacs.
woman on laptop sitting at the window

Install Bywater BASIC on your FreeDOS system and start experimenting with BASIC programming.
Files in a folder

Here's how I transfer files between my FreeDOS virtual machine and my Linux desktop system.

About the author

photo of Jim Hall
Jim Hall - Jim Hall is an open source software advocate and developer, best known for usability testing in GNOME and as the founder + project coordinator of FreeDOS. At work, Jim is CEO of Hallmentum, an IT executive consulting company that provides hands-on IT Leadership training, workshops, and coaching.