Skip to content
Misha edited this page Jan 15, 2022 · 34 revisions

Frequently Asked Questions

HELP im getting Error while invoking IL2CPU

This is also a generic error in some cases. It happens everytime the assembler fails to build it, eg, Visual Studio 2019 recognizes Int16 as found, but the assembler cannot due to a missing Plug

What does Cosmos stand for?

Officially is it the C# Open Source Managed Operating System, but we just go by Cosmos.

In fact, the name Cosmos was chosen before any meaning was attributed to it. Later we decided by chance what the letters stood for. Thus it is also Cosmos, and not COSMOS or CosmOS.

And besides, VBOSMOS sounds stupid.

Can I code in something besides C#?

Yes. Despite C# being in the Cosmos name, any .NET Core language can be used including Visual Basic.NET, F#, Delphi, Chrome and more. In fact, Cosmos will work with any .NET language that compiles to pure IL without P/Invokes. The C# refers to what we use to build Cosmos itself and is simply our personal preference of language.

Can I use Visual Studio Community?

Visual Studio Community Edition is fully supported by Cosmos.

Can I run on something besides VMWare?

Yes. Cosmos runs on real hardware (and you can debug with a serial cable) as well as Virtual PC, HyperV, Virtual Box and others. See Deployment.

We have Visual Studio integration for running using VMware and Bochs.

Does Cosmos support Mono?

We supported Mono in the past and will again in the future. Currently Mono support is disabled merely as a way to focus our limited resources as Mono requires a different set of plugs.

What processors does Cosmos support?

Cosmos currently only runs on x86 and x64 processors. It has the capability to run on ARM and other processors as well but currently only Intel is supported.

Does Cosmos support graphics, networking, filesystem, etc.?

Have a look at Features Users have produced demos that use basic networking and graphics, but the core team is still focused on kernel and debugger. When we have the foundation built to a sufficient level the core team will integrate the work of users into Cosmos itself.

To answer your question, Cosmos currently has a working VMware SVGA driver (up to 1920x1200, but only works on VMware) and a non-working-at-the-moment VGA driver (up to 320x200, wow!). (Edit: CSM is the new way to make a UI. the VGA driver is deprecated.)

Basic networking is being worked on, and our FAT drive works but has bugs.

I'm getting an error about a plug. What can I do?

Please see Plugs.

Why not using Linux kernel with Mono? Why the effort to write a kernel?

Creating our kernel written in C# and our run time we will accomplish a lot of advantages respect to use the Linux kernel:

There will be only a version of Cosmos that will run on any CPU (code once run everywhere) The OS will be safer using the Linux kernel we will expose us to all the security bug that C code has Cosmos and the applications will condivide the same memory space using the .NET runtime to isolate processes memory. At the same time when needed a process could give the "ownership" of an object to another process directly without the need to serialization; a reference to the very same object will be used Cosmos will permit to implement Zero Copy I/O very easily (faster web server ever?) Using C# will permit us to code and debug using Visual Studio to debug the kernel itself Not using the Linux kernel we do not take the dependency from others and are more free to do our choices

How is Cosmos licensed?

Cosmos is licensed under the New BSD license. Please see License

Who develops Cosmos?

Some crazy eccentric developers.

Why develop Cosmos?

Primarily because it's fun. But beyond that, how else can you boot .NET on a floppy or small USB stick? Who else will try to put .NET on the Wii, OLPC, and iPhone?

We are also developing a TCP/IP stack. Imagine instead of deploying half a dozen virtualized OS's, deploying many dozens of dedicated OS's. One that only does DNS, a few that only do HTTP, etc. One instance, one function.

What is the Project Vision?

World domination of course, but until we achieve that our goals are:

A reliable OS which never hangs (of course until the hardware fails). Whichever program crashes, the OS should never hang or go unresponsive. Very safe (safe in the sense which is free from buffer overflows, heap overflows, exploits etc.) Drivers and programs being able to be verifiable/tested. Even the Kernel should be verifiable at a later stage (maybe using TALx86) The LINUX of tomorrow.

How does Cosmos compare to Singularity?

Cosmos and Singularity have a lot in common. Singularity however is only a research project to determine the usefulness of pieces that might later be used in .NET and or future versions of Windows. Singularity itself is not intended to ship as a Microsoft supported the operating system. In March 2008 Singularity was released to the public on CodePlex. However the license is for academic use only and thus differs greatly from the goals of Cosmos. Developers of Cosmos should not look at Singularity source to avoid contaminating Cosmos and violating the Singularity license.

If you have looked at Singularity the past, you are welcome to develop on Cosmos however you must be careful not to use your knowledge of Singularity. Unless you were involved deeply into Singularity code this will likely not be a problem. If you are concerned about this, choose purposefully to develop in a different area of functionality in Cosmos.

How does Cosmos compare to the .NET Micro Framework?

The .NET Micro Framework targets tiny devices and is interpreted. Cosmos targets both large and low resource machines and is compiled.

Can Cosmos be developed using 64-bit Windows?

Yes. Many of the developers on the team are using 64-bit Windows.

What version of Visual Studio can I use to develop Cosmos?

Visual Studio 2019 is the only version supported by the user and devkit. We no longer support older versions such as Visual Studio 2017 due to breaking changes in Visual Studio Project System. The last version which supports Visual Studio 2017 is https://github.com/CosmosOS/Cosmos/releases/tag/Userkit_20181010.

What is this .editorconfig file and how do I use it?

The EditorConfig project defines a simple file format for configuring common text-editor options such as indentation sizes. These configuration files are designed to sit alongside a project's source code, allowing text editors to use the right options on a file-by-file basis. The EditorConfig project provides plugins for many common text editors, making the format fully cross-platform.

You can download and install EditorConfig support for Visual Studio here.

What works?

Console apps mostly for now. When we have more of the foundational pieces we will move to graphics.

What is the Devkit?

The Devkit is the source code for Cosmos. You can download it from the Source Code tab to take a look or even install it. See Devkit for information on how to install it. Keep in mind the latest Devkit contains the latest code, which may be unstable or untested. If you don't like hunting for bugs, take a look at the Devkits listed on the Releases page.

Why can't I install the devkit (it reports errors while compiling it)?

Make sure you have Inno setup, VMware and that you have updated Visual Studio 2019 to Update 1 or later. The easiest way to update is to go to the build.sln and it will probably say that the project has multiple projects and give you a link which you will click. Then update VS2019 and make sure you check ALL the extensibility tools. If VMware does not work, but it should repair it from the setup. Another thing to make sure is that install-VS2019.bat match up with you're Visual Studio version.

What is X#?

The goal is that Cosmos developers will never need to write assembly language. However, a few of us working in the compiler and debugger areas must work with assembly language. To ease our task we have developed an HLA (High-level assembler) which uses a language called X#.

I get an error about HAL and rings and stuff.

This is usually caused by using HAL code (ring 1) in Ring 3, your kernel. You must make a pass over layer from Ring 3 to Ring 2 to Ring 1 to access HAL functions.1 to access HAL functions.

Clone this wiki locally