Upgrading to API v1.0 series
Follow the compatibility notes when upgrading your mods to API v1.0 series
Last updated
Follow the compatibility notes when upgrading your mods to API v1.0 series
Last updated
When upgrading your modification from the target of the later version of Nitrocid KS that declares itself to be from the API v1.0, you must make necessary changes to be able to use your mod in a Nitrocid KS version which you use to test your mod. These changes will be listed starting from 0.0.4 to the last version in this API revision.
Although this version is the first version which supported the kernel modification feature, these below functions are removed for reasons stated below each function.
ResetTimeDate()This function first appeared in 0.0.3 as part of the changes that happened between 0.0.2 and the aforementioned version. However, this function only nullified the values of the kernel time and date variables, making this function rather redundant. It was removed.
We advice you to cease using this function.
permissionEdit()This function first appeared with the initial debut of the group system. However, it got removed because, according to the analysis made in 2021, permission() function already did its job. Further examination revealed that it was only trying to edit the permission for a user, but, in the process of doing so, it cloned what permission() would do.
The new permission system is here, and you can make use of it to grant and deny users a specific permission. Their method signatures are written below:
ProbeBIOS()This function was added to "simplify" silencing the messages being seen when the BIOS probing started. The boolean value in the function indicated if the messages are going to be suppressed during the BIOS probing. However, it was removed as unnecessary because it was a wrapper to the function that probed the computer about the information of the BIOS.
We advice you to cease using this function.
This version incorporated a few changes to the kernel, including the below API changes that may impact your mods.
ShowTimeQuiet()This function was created back in 0.0.2 to wrap the conditional execution of ShowTime(). This was generally a shortcut to checking to see if the kernel quiet mode is enabled. However, it was deemed unnecessary, and, thus, removed.
Latest generations of Nitrocid KS offer better quiet mode, which functions more dynamically than the implementation on the first-generation versions. We advice you to cease using this function.
This kernel version incorporated changes to the kernel, such as these API changes that occurred:
DiscoSystem()The very first screensaver ever implemented in the very first version of Nitrocid KS. However, it was implemented in the DiscoSystem() function which, unfortunately, situated in the GetCommand module, which was a wrong place to start with. It was removed in 0.0.5.
This screensaver was later implemented in later versions of Nitrocid KS as one of the genuine screensavers under the name of Disco. We still advice you to stop using this function.
BeepFreq() and BeepSystem()This function served as the prompt handler for the beep system. Actually, this is the Stage 1 function for prompting the user to provide the value of the frequency in hertz. The below function, BeepSystem(), is the second-stage function that prompts the user for the duration of the beep in seconds. Both of these functions are removed as part of the mass prompt obsoletion movement that started in the middle of the revision.
Though the beep command returned without frequency and time support in later revisions, these functions are removed. The prompt obsoletion movement was something we regret making thanks to the evolution of the kernel as revisions come and go.
The reason that the beep command returned without the beeping customizability is that because it's not cross-platform.
CheckNetworkKernel(), CheckNetworkCommand(), and PingTargetKernel()These functions come as a duo, presenting different ways to do just one job: pinging the target. However, each function calls their sibling function, PingTargetKernel() and PingTarget(), the latter of which is not removed. They're removed as a completely unnecessary kernel argument was removed with it and as part of the prompt obsoletion movement.
This function was returned much later as a cross-platform method to ping network devices in the NetworkTools.PingAddress() function. The below code block can be used to show you the method signature of the function in the latest kernel version.
panicPrompt()This was implemented as the normal command that you can easily run from the shell. As this was declared as abusive, we've removed the function.
This function was later re-implemented as a test facade, which, along with the entire kernel testing system, is only available in debug builds of the kernel. Either way, we've internalized the function responsible for the kernel error.
changeName()This function was used to change the username to another name using prompts, but that function was removed as a result of the prompt obsoletion movement.
This function made its own return under ChangeUsername() in the same module. The code block below shows you the method signature of the function.
changePassword() and changePasswordPrompt()Both functions prompt for the same thing, which is changing the target user password. These functions are confusingly named, because the first one prompted for the username whose password will be changed, and the second function prompted for the new password to set for the user. Both of the functions are removed as part of the prompt obsoletion movement.
Password changing is returned in later versions of the kernel starting with 0.0.12 under the ChangePassword() function. Below code block shows you the method signature for the new function.
removeUser()This function used to prompt you for the user which was to be removed. However, it was removed as part of the prompt obsoletion movement.
This function was later returned. The below code block shows you the method signature.
addUser() and newPassword()The first function used to prompt you for the new user, which, after being provided the new user to create, the second function was called to prompt you for the password of the new user. Both functions are removed as part of the prompt obsoletion movement.
AddUser() was later implemented in the latest kernel versions. The below code block shows you the usage of the routine.
UseDefaults(), SetColorSteps(), and advanceStep()The first function was called by SetColorSteps() to get the default values of the kernel template from the number in the global variable that was incremented by the SetColorSteps() function itself.
The 2021 analysis of the removed functions says that it was removed as part of the prompt obsoletion movement, but it was actually removed as improvements waded in to the kernel coloring system. This latest analysis is true for both the UseDefaults() and advanceStep() functions, but the second one was removed for the prompt removal reason.
We advice you to use PopulateColorsDefault() implemented in 0.1.0 Beta 1 as an alternative to the first function. For the second one, use the SetConsoleColor() function found under KernelColorTools as shown in the method signature in the below code block.
TemplatePrompt()This function used to prompt you for writing the template name to set the kernel colors to match the selected template. It was removed as part of the prompt obsoletion movement.
Use SetColorsTheme(), ApplyThemeFromFile(), or ApplyThemeFromResources() as viable functions to set your theme. The below code block shows you the method signature. Also, the themesel command shows you the list of themes and allows you to choose between available themes.
This release was a minor release to the 0.0.5.x series.
permissionPrompt() and permissionEditingPrompt()The first function served as the prompt for adding and removing groups for users, and the second function prompted you for editing the groups. Both of these functions were later removed as part of the prompt obsoletion movement.
The new permission system replaces the two functions with more API-friendly functions that can be found in the PermissionsTools class. However, if you're referring to actual user groups, you may want to take a look at the GroupManagement class instead.
0.0.6 brought several features, including the API changes described below:
initializeMainUsers()This function usused to add the master system account for the kernel known as "root", a familiar name for the superuser account in Linux systems. It was found to be duplicating what adduser() does in the same version of the kernel, so we decided to merge it to adduser().
The 2021 analysis said that it was removed as it's no longer needed, but it pointed to Login.vb where no such function exists.
Even though this function returned in later versions of the kernel as InitializeSystemAccount() in 0.0.12, we advice you to cease using this function.
ReadLineWithNewLine()This StreamReader extension used to read one line ending in the new line character from the file stream reader. It got removed as part of the migration to Extensification, which is our (obsolete) project dedicated to giving you additional extensions.
We advice you to cease using this function. The codebase to implement this function is still found in the archived Extensification repository, but we advice you to re-implement this functionality yourself.
ReadyPath_MOD()This function was implemented as part of the addition of Unix systems to the supported host systems. It was later removed as unnecessary.
If you want to get a path to your mod directory, use the ModsPath property found in the Paths module. Alternatively, you can use a function to get said kernel path with the GetKernelPath function if you pass it the KernelPathType.Mods value.
ProbeGPU(), Hddinfo(), Cpuinfo(), SysMemory(), and BiosInformation()These hardware parsing functions used to probe information about your computer's graphics card, hard drive (including SSDs), CPU, memory, and BIOS. These functions have since been removed as a merger to ProbeHardware(), but it got removed again after Inxi.NET got released.
ListHardware is implemented to show you info about hardware based on supported types, or "all" to show everything. The method signature shows you how you can use this method defined in HardwareList.
PreWriteToDebugger, PostWriteToDebugger, PreWriteToConsole, and PostWriteToConsole eventsThese events were raised if the conditions were met:
If any console writer tried to write something to the console, the PreWriteToConsole event was raised before it's written. After performing the operation, PostWriteToConsole was raised.
If the debug writer tried to write debug info to the debug file when the kernel debugger is on, the PreWriteToDebugger event was raised before it's written. After that, PostWriteToDebugger event was raised.
Our main issue was that performing this operation caused us to significantly slow down the performance, so they remained unused and given the Obsolete attribute before getting removed.
There is no alternative to these events, so we recommend you to avoid using these events in your mods if possible. This is an upgrade block for your mods until you follow our advice.
ResetUsers()This function used to reset every variable related to user management, including the outputs and the inputs. It got merged to ResetEverything()
We advice you to cease using this function.
GetAllCurrencies()This function used to list all the currencies of all the countries supported by the free.currencyconverterapi.com API site. However, the operators behind it converted the API to paid model, so we removed it following that change.
We no longer support currency conversions as part of the current state of the economy, including the recent inflations. We advice you to cease using this feature if possible.
CurrencyConvert()This function used to query the aforementioned API to convert the value from the source country currency to the target country currency. It got removed when the free.currencyconverterapi.com operators moved to the paid-only model.
We no longer support currency conversions as part of the current state of the economy, including the recent inflations. We advice you to cease using this feature if possible.
This version series is the last version group for Nitrocid KS API v1.0, which incorporated many changes, such as the addition of languages. In contrast, the following APIs are removed:
ExpressionCalculate()For the standard calculator, it calculates all the expressions that consist of just numbers and operators and prints their results to the console. It takes the expression list and lists all numbers and operators in their separate lists and combines them to the final expression string to be computed by the DataTable class which can be found by clicking below:
In the other hand, the scientific calculator does the same thing, but also checks to see if it's running in sin-cos-tan mode (also wrongly named as scientific mode).
These functions were removed because their support for expressions are extremely limited and the implementation is fragile, as it doesn't check for parentheses, powers, and so on.
This function later returned with the usage of StringMath in the later kernel versions. Before the migration, in 0.0.12, it has returned under DoCalc().
Converter()This converter used to take both the source unit and the target unit to convert the value to the target unit. A removal was made as a result of it being hard to maintain.
It was later returned with the usage of Units.NET library.
Wln()This function was implemented to create a separate version of W() (now Write()) that also prints the new line after writing the needed string to the console. It was removed as it was being merged by W().
Use the lines boolean parameter to make Write() make a new line after it writes down the needed text.
ReadImportantConfig()ThThis function was used by the config initialization routine to read configuration entries that were deemed as important. This, however, was merged to the main config reader where it was given substantial updates before eventually getting removed in 0.1.0 as part of the new config reader and writer.
We advice you to cease using this function.
GenModCS()The modding system first saw support for C# in 0.0.6.2, so this function was implemented separately. However, it got merged to GenMod() with this version series.
This function was not part of the public API, but listed here according to the 2021 analysis. The modification system in the latest series now supports .DLL files, but withdraws support for a single .cs and .vb mods.
The manual page for Nitrocid KS was first situated in the application itself using an in-house format known as the .ksman extension. It was the start of the actual product documentation, until several display issues on the manual API surfaced with the release, especially on Linux systems. We had to make several fixes before abandoning the entire viewer.
The parser, however, works well. We recently had time issues with translating pretty much every manual page to the point that the manual page count was very high. We felt like that it was a very high volume, so we decided to remove them, and migrate the manual to GitHub Wiki.
The manual page feature made its own return for 0.0.20, but it only works for mods and not the actual user guide for Nitrocid KS, which is what you're reading here.
To learn more about how manual pages work and how to use them for your mods, press the below link:
ListLocal()This function was a helper function to list all local directories, but specialized for the FTP shell that first appeared in 0.0.5.5. It was later removed because it was duplicating what List() was doing.
We advise you to cease using this function, and start using the List() function. The method signature for this function is listed below.
PingTarget()This function was used to ping a remote computer or remote server across the LAN and across the entire Internet. It was removed because it was functionally using the My.Computer API which wasn't cross-platform and was restricted to Visual Basic, which defeats the purpose of cross-platform applications.
This function was returned much later as a cross-platform method to ping network devices in the NetworkTools.PingAddress() function. The below code block can be used to show you the method signature of the function in the latest kernel version.
These four functions were made to list all the computers in the LAN. The first one lists all the offline and online hosts by taking cached computer list, the second and the fourth one lists all the online computers either by listing them or by putting them under the tree-based diagram, and the third function actually uses SAMBA 1.0, which is highly insecure considering that there are many security vulnerabilities regarding this version of SAMBA which is linked below.
As a consequence, we decided to remove the whole API, making the kernel non-dependent on SAMBA 1.0.
It was later returned in 0.1.0 pre-beta, but it doesn't use the insecure SAMBA 1.0 protocol. Instead, it uses ICMP pinging to check for all online devices in the LAN. You can use this function as listed below.