fix issues with makefile and shell.nix, fix backspace bug

Author: alexeev-prog

CHANGELOG.md

@@ -1,3 +1,9 @@
+commit 20bb0ee3f10fb3038fe786707da6aaac09273f3d
+Author: Alexeev Bronislav <alexeev.dev@mail.ru>
+Date:   Sat Aug 23 05:14:12 2025 +0700
+
+    docs: update readme and add docs
+
 commit fc36ce4c4630d7468c9cc562f977fbc3bcf51146
 Author: Alexeev Bronislav <alexeev.dev@mail.ru>
 Date:   Sat Aug 23 04:14:24 2025 +0700

Makefile

@@ -55,30 +55,29 @@ $(BIN_DIR)/%.o: $(SRC_DIR)/%.c
 	@mkdir -p $(dir $@)
 	@$(CC) $(CFLAGS) -c $< -o $@
 
-diskimg: $(BIN_DIR)/kintsugios.bin
-	@printf "$(BLUE)[DD]   Make IMG  %-50s -> %s$(RESET)\n" "$(BIN_DIR)/kintsugios.bin" "$(DISKIMG_DIR)/$(DISKIMG_NAME)"
+$(DISKIMG_DIR)/$(DISKIMG_NAME): $(BIN_DIR)/kintsugios.bin
+	@printf "$(BLUE)[DD]   Make IMG  %-50s -> %s$(RESET)\n" "$(BIN_DIR)/kintsugios.bin" "$@"
 	@mkdir -p $(DISKIMG_DIR)
-	@dd if=/dev/zero of=$(DISKIMG_DIR)/$(DISKIMG_NAME) bs=1024 count=1440
-	@dd if=$(BIN_DIR)/kintsugios.bin of=$(DISKIMG_DIR)/$(DISKIMG_NAME) conv=notrunc
+	@dd if=/dev/zero of=$@.tmp bs=1024 count=1440
+	@dd if=$< of=$@.tmp conv=notrunc
+	@mv $@.tmp $@
+
+diskimg: $(DISKIMG_DIR)/$(DISKIMG_NAME)
 
 run_bin: $(BIN_DIR)/kintsugios.bin
 	@printf "$(GREEN)[QEMU] Run bin   %-50s$(RESET)\n" "$(BIN_DIR)/kintsugios.bin"
 	@qemu-system-i386 -fda $(BIN_DIR)/kintsugios.bin
 
-run: diskimg
-	@printf "$(GREEN)[QEMU] Run img   %-50s$(RESET)\n" "$(DISKIMG_DIR)/$(DISKIMG_NAME)"
-	@qemu-system-i386 -fda $(DISKIMG_DIR)/$(DISKIMG_NAME) -boot a
+run: $(DISKIMG_DIR)/$(DISKIMG_NAME)
+	@printf "$(GREEN)[QEMU] Run img   %-50s$(RESET)\n" "$<"
+	@qemu-system-i386 -fda $< -boot a
 
-debug: diskimg
-	@printf "$(GREEN)[QEMU] Debug img %-50s$(RESET)\n" "$(DISKIMG_DIR)/$(DISKIMG_NAME)"
-	@qemu-system-i386 -fda $(DISKIMG_DIR)/$(DISKIMG_NAME) -boot a -s -S
+debug: $(DISKIMG_DIR)/$(DISKIMG_NAME)
+	@printf "$(GREEN)[QEMU] Debug img %-50s$(RESET)\n" "$<"
+	@qemu-system-i386 -fda $< -boot a -s -S
 
 clean:
 	@printf "$(RED)[RM]   Clean bin %-50s$(RESET)\n" "$(BIN_DIR)"
-	@rm -rf $(BIN_DIR)/*
-
-clean_all:
-	@printf "$(RED)[RM]   Clean all %-50s$(RESET)\n" "$(BIN_DIR)"
 	@rm -rf $(BIN_DIR)/* $(DISKIMG_DIR)/*
 
-.PHONY: all diskimg run run_bin clean clean_all
+.PHONY: all diskimg run run_bin debug clean clean_all

README.md

@@ -1,7 +1,8 @@
 # KintsugiOS
-
 Минималистичная x86 операционная система на (N)ASM и C, созданная в образовательных целях для глубокого понимания принципов работы операционных систем.
 
+ > Также я занимаюсь [переводом OSDEV-Notes](https://github.com/alexeev-prog/Osdev-Notes-RU)
+
 <div align="center">
 <img src=https://img.shields.io/github/languages/top/alexeev-prog/KintsugiOS>
 <img src=https://img.shields.io/github/license/alexeev-prog/KintsugiOS>
@@ -50,52 +51,17 @@
 Для сборки и запуска KintsugiOS необходим следующий инструментарий:
 
 - [Кросс-компилятор i386 ELF GCC](http://newos.org/toolchains/i386-elf-15.1.0-Linux-x86_64.tar.xz)
-- FASM 1.73.31 или новее
-- NASM 2.16 или новее
+- FASM
+- NASM
 - GDB для отладки
-- MTools и Xorriso для создания образов дисков
-- QEMU или Bochs для эмуляции
+- MTools и Xorriso
+- QEMU или Bochs
 
 Проверить готовность окружения можно скриптом:
 ```bash
 ./check-env.sh
 ```
 
-## Структура проекта
-
-```
-src/
-├── bootloader/           # Код загрузчика
-│   ├── bootsector.asm    # Главная загрузочная запись
-│   ├── diskload.asm      # Чтение с диска
-│   ├── gdt.asm           # Глобальная таблица дескрипторов
-│   ├── kernel_entry.asm  # Точка входа в ядро
-│   ├── puts_chars.asm    # Вывод текста (16-бит)
-│   ├── puts_chars32.asm  # Вывод текста (32-бит)
-│   ├── puts_hex.asm      # Вывод hex-чисел
-│   └── switch_to32.asm   # Переход в защищённый режим
-└── kernel/               # Ядро ОС
-    ├── cpu/              # Центральные модули процессора
-    │   ├── idt.[ch]      # Таблица дескрипторов прерываний
-    │   ├── interrupt.asm # Обработчики прерываний
-    │   ├── isr.[ch]      # Службы прерываний
-    │   ├── ports.[ch]    # Работа с портами ввода-вывода
-    │   ├── timer.[ch]    # Системный таймер
-    │   └── type.h        # Общие типы данных
-    ├── drivers/          # Драйверы устройств
-    │   ├── keyboard.[ch] # Драйвер клавиатуры
-    │   ├── lowlevel_io.[ch] # Низкоуровневый ввод-вывод
-    │   └── screen.[ch]   # Драйвер экрана
-    ├── kernel/           # Основное ядро
-    │   ├── kernel.[ch]   # Главные функции ядра
-    │   ├── utils.[ch]    # Вспомогательные утилиты
-    └── libc/             # Стандартная библиотека C - KKLIBC (Kintsugi Kernel LibC)
-        ├── function.h    # Вспомогательные макросы
-        ├── mem.[ch]      # Управление памятью
-        ├── stdio.[ch]    # Стандартный ввод-вывод
-        └── string.[ch]   # Работа со строками
-```
-
 ## Сборка и запуск
 
 ### Базовая сборка

shell.nix

@@ -18,9 +18,6 @@ pkgs.mkShell {
 
   shellHook = ''
     export PATH="${customToolchainPath}:$PATH"
-    # Опционально: устанавливаем переменные окружения для удобства
-    export CC="i386-elf-gcc"
-    export AS="i386-elf-as"
     echo "Environment ready for KintsugiOS development!"
     echo "Using cross-compiler from: ${customToolchainPath}"
     echo "Type 'make run' to build and launch in QEMU (if your Makefile supports it)"

src/kernel/drivers/keyboard.c

@@ -13,6 +13,7 @@
 #include "../libc/string.h"
 #include "../libc/function.h"
 #include "../kernel/kernel.h"
+#include "../libc/stdio.h"
 
 #define BACKSPACE 0x0E
 #define ENTER 0x1C
@@ -29,6 +30,7 @@ const char *sc_name[] = { "ERROR", "Esc", "1", "2", "3", "4", "5", "6",
         "A", "S", "D", "F", "G", "H", "J", "K", "L", ";", "'", "`",
         "LShift", "\\", "Z", "X", "C", "V", "B", "N", "M", ",", ".",
         "/", "RShift", "Keypad *", "LAlt", "Spacebar"};
+
 const char sc_ascii[] = { '?', '?', '1', '2', '3', '4', '5', '6',
     '7', '8', '9', '0', '-', '=', '?', '?', 'Q', 'W', 'E', 'R', 'T', 'Y',
         'U', 'I', 'O', 'P', '[', ']', '?', '?', 'A', 'S', 'D', 'F', 'G',
@@ -38,20 +40,18 @@ const char sc_ascii[] = { '?', '?', '1', '2', '3', '4', '5', '6',
 static void keyboard_callback(registers_t regs) {
     /* PIC выходы сканкодов в порту 0x60 */
     u8 scancode = port_byte_in(0x60);
+    int current_offset = get_cursor_offset();
 
     if (scancode > SC_MAX) return;
     if (scancode == BACKSPACE) {
-        if (shell_cursor_offset <= shell_prompt_offset) {
+        // kprintf("%d %d\n", current_offset, shell_prompt_offset);
+        // return;
+        if (current_offset <= shell_prompt_offset) {
             return;
         }
 
         backspace(key_buffer);
         kprint_backspace();
-
-        backspace(key_buffer);
-        kprint_backspace();
-
-        shell_cursor_offset = get_cursor_offset();
     } else if (scancode == ENTER) {
         kprint("\n");
         user_input(key_buffer); /* функция под управлением ядра */
@@ -63,7 +63,7 @@ static void keyboard_callback(registers_t regs) {
         if(strlen(key_buffer) < sizeof(key_buffer) - 1) {
             append(key_buffer, letter);
             kprint(str);
-            shell_cursor_offset += 2;
+            shell_cursor_offset = get_cursor_offset();
         } else {
             kprint("Keyboard buffer is overflow.");
         }

src/kernel/kernel/kernel.c

@@ -62,7 +62,6 @@ void user_input(char *input) {
 		//   Команда            		Подсказка для команды                  	 					Указатель до функции
 		{.text="END",		   		.hint="HALT CPU", 											.command=&halt_cpu},
 		{.text="CLEAR", 	   		.hint="Clear screen",										.command=&clear_screen_command},
-		{.text="AMALLOC", 		   	.hint="Kernel Arena Malloc. Usage: AMALLOC <size>",			.command=&arena_malloc_command_shell},
 		{.text="QEMUSHUTDOWN",		.hint="Shutdown QEMU",										.command=&shutdown_qemu},
 		{.text="INFO",				.hint="Get info",											.command=&info_command_shell},
 		{.text="FREEMEMADDR",		.hint="Get free mem addr",									.command=&print_freememaddr},
@@ -102,6 +101,6 @@ void user_input(char *input) {
     // Вывод строки шелла
     kprint("\n!#> ");
 
-	shell_cursor_offset = get_cursor_offset(); // get_cursor_offset из screen.c
+	shell_cursor_offset = get_cursor_offset();
     shell_prompt_offset = shell_cursor_offset;
 }

src/kernel/kernel/utils.c

@@ -52,23 +52,6 @@ void info_command_shell(char** args) {
 	kprintf("Block count: %d\n", meminfo.block_count);
 }
 
-void arena_malloc_command_shell(char** args) {
-	if (args[0] == NULL) {
-		kprint("AMALLOC usage: AMALLOC <page size>");
-		return;
-	}
-
-	u32 phys_addr;
-	u32 page = kmalloc(strtoint(args[0]), 1, &phys_addr);
-	char page_str[16] = "";
-	hex_to_ascii(page, page_str);
-	char phys_str[16] = "";
-	hex_to_ascii(phys_addr, phys_str);
-
-	kprintf("ARENA MALLOC %d bytes\n", strtoint(args[0]));
-	kprintf("Page address: %s\nPhysical address: %s\n", page_str, phys_str);
-}
-
 void mem_dump(char** args) {
 	kmemdump();
 }
@@ -103,7 +86,7 @@ void kmalloc_command(char** args) {
 	}
 
 	int size = strtoint(args[0]);
-	void* ptr = kmalloc_new(size);
+	void* ptr = kmalloc(size);
 
 	char buf1[32] = "";
 	hex_to_ascii((int)ptr, buf1);
@@ -112,9 +95,9 @@ void kmalloc_command(char** args) {
 }
 
 void test_mem_command(char** args) {
-    void* ptr1 = kmalloc_new(64);
-    void* ptr2 = kmalloc_new(128);
-    void* ptr3 = kmalloc_new(256);
+    void* ptr1 = kmalloc(64);
+    void* ptr2 = kmalloc(128);
+    void* ptr3 = kmalloc(256);
 
 	char buf1[32] = "";
 	char buf2[32] = "";

src/kernel/kernel/utils.h

@@ -7,7 +7,6 @@ void shutdown_qemu(char** args);
 void halt_cpu(char** args);
 void help_command_shell(char** args);
 void info_command_shell(char** args);
-void arena_malloc_command_shell(char** args);
 void test_mem_command(char** args);
 void mem_dump(char** args);
 void clear_screen_command(char** args);

src/kernel/libc/mem.c

@@ -57,7 +57,7 @@ void *get_physaddr(void *virtualaddr) {
     return (void *)((pt[ptindex] & ~0xFFF) + ((unsigned long)virtualaddr & 0xFFF));
 }
 
-void* kmalloc_new(u32 size) {
+void* kmalloc(u32 size) {
     // Выравниваем размер до границы BLOCK_SIZE
     if (size % BLOCK_SIZE != 0) {
         size += BLOCK_SIZE - (size % BLOCK_SIZE);
@@ -165,38 +165,6 @@ void kmemdump() {
     }
 }
 
-// LEGACY Arena
-/* Реализация - это просто указатель на некоторую свободную память, которая продолжает расти */
-u32 kmalloc(u32 size, int align, u32 *phys_addr) {
-
-    if(free_mem_addr_guard1 != 0xDEADBEEF || free_mem_addr_guard2 != 0xCAFEBABE) {
-        kprint("PANIC: Memory corruption detected around free_mem_addr!\n");
-        // Зависаем или перезагружаемся
-        // asm volatile("hlt");
-        return -1;
-    }
-
-    /* Страницы выровнены по 4K, или 0x1000 */
-    if (align == 1 && (free_mem_addr & 0xFFFFF000)) {
-        free_mem_addr &= 0xFFFFF000;
-        free_mem_addr += 0x1000;
-    }
-    /* Сохранить также физический адрес */
-    if (phys_addr) *phys_addr = free_mem_addr;
-
-    kprint("kmalloc legacy: allocating ");
-    char size_str[16] = "";
-    hex_to_ascii(size, size_str);
-    kprint(size_str);
-    kprint(" bytes at ");
-    get_freememaddr();
-    kprint("\n");
-
-    u32 ret = free_mem_addr;
-    free_mem_addr += size;
-    return ret;
-}
-
 void get_freememaddr() {
     char free_mem_addr_str[32] = "";
 	hex_to_ascii(free_mem_addr, free_mem_addr_str);

src/kernel/libc/mem.h

@@ -35,11 +35,10 @@ meminfo_t get_meminfo();
 void memory_copy(u8 *source, u8 *dest, int nbytes);
 void memory_set(u8 *dest, u8 val, u32 len);
 void get_freememaddr();
-u32 kmalloc(u32 size, int align, u32 *phys_addr);
 
 // Новые функции
 void heap_init();
-void* kmalloc_new(u32 size);
+void* kmalloc(u32 size);
 void kfree(void* ptr);
 void kmemdump();