snark13
4a081501d8
- bios/conio/env/errno/gfx/io/mem/mouse/stdio/stdlib/string/sys/time/ video разложены по модулям: общие статики и helpers — в internal _-модулях (_conio.h/_mouse.h/_gfx.h/_palette.h/_atexit.h/_time.h) - lib/Makefile: LIBC_C = wildcard libc/*/*.c — гранулярность файлов = гранулярность DCE линкера - эффект _CODE: gfx_text 6986→2568 Б, gfx_mous −1745, gfx_demo/d16 −542; ранее timedir −3270, ls −3098, stattest −2995 - комментарии оставшихся модулей переведены на русский; puts: убран мёртвый pchars; videomode_raw разложен на get/set - docs/libc-split-asm-cases.md — правила asm-связок между модулями; docs/libc-roadmap.md — план этапа - восстановлен examples/mdview/SAMPLE.MD (нужен make floppy) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
132 lines
9.9 KiB
Markdown
132 lines
9.9 KiB
Markdown
# libc — план работ (на рассмотрение, 2026-07-06)
|
||
|
||
Анализ после сплита четвёрки лидеров (time/stat/file/conio, итог −19.6 КБ
|
||
суммарно по _CODE приложений). Ниже — что ещё стоит сделать, по приоритетам.
|
||
|
||
---
|
||
|
||
## П1. Досплит остальной libc — СДЕЛАНО 2026-07-06
|
||
|
||
Всё из таблицы ниже посплитано (кроме dec_print — осознанно оставлен).
|
||
gfx: 40 модулей (внутренний заголовок `libc/gfx/_gfx.h`, скретчи в
|
||
data-модулях `_gfx_state/_gfx_w3_state/_gfx_acc256/_gfx_g16_state/
|
||
_gfx_font_state`, helpers `_gfx_hfill256/_gfx_hfill16/_gfx_rmw16/
|
||
_gfx_text16`); video/palette → 7 модулей + `_palette.h`;
|
||
conio/text_palette → 5 модулей. Эффект (_CODE, Б):
|
||
gfx_demo 3769→3227, gfx_d16 3869→3327, gfx_text 6986→2568,
|
||
gfx_mous 7287→5542. Не-gfx тесты не изменились.
|
||
|
||
Правило было: 1 публичная функция = 1 модуль, state/helpers — в отдельные
|
||
internal-модули, комментарии на русском, без `= 0`.
|
||
|
||
| Файл | Ф-ий | _CODE | Замечания |
|
||
|---|---|---|---|
|
||
| gfx/gfx_256.c + gfx_16.c | 13+13 | 1277+1159 Б | самый жирный кусок; резать по примитивам (putpixel/line/hline/vline/rect/fill/clear/text). Учесть SMC-паттерны акселератора и кэш Port_Y — state в data-модули |
|
||
| gfx/gfx_raw_16 / raw_256 / raw_common / core / palette / font / text_* | ~40 | ~2.7 КБ | вместе с предыдущим — весь gfx |
|
||
| mouse/mouse.c | 16 | 308 Б | state mb_*/mc_* → data-модули |
|
||
| bios/text.c | 14 | 264 Б | все `__naked`, сплит чистый |
|
||
| io/open.c | 3+3 | 216 Б | open/creat/close; asm-хелперы `_estex_*_raw` у единственных потребителей |
|
||
| errno/errno.c | 2 | 680 Б | strerror + таблица строк неразделимы (один модуль); perror — отдельно, зовёт strerror |
|
||
| video/palette.c | 6 | 348 Б | |
|
||
| conio/text_palette.c | 5 | 140 Б | |
|
||
| io/read.c | 2 | 60 Б | read + write — обязательно врозь (write-only приложения) |
|
||
| io/fsdir.c | 4 | 80 Б | mkdir/rmdir/chdir/getcwd |
|
||
| env/env.c | 3 | 78 Б | getenv/putenv/sysenv + общий env_buf → data-модуль |
|
||
| mem/mem_bios, mem_estex, bank_io_w1/w3 | 3–4 каждый | ~430 Б | |
|
||
| sys/atexit.c | 3 | 106 Б | atexit/exit/_exit; общий стек хендлеров → data-модуль (exit тянется всегда из crt0, выигрыш небольшой но правильный) |
|
||
| io/dir.c | 2 | 53 Б | ffirst/fnext |
|
||
| stdlib/minmax.c | 2 | 27 Б | min/max врозь |
|
||
| stdio/hex_print.c | 3 | 38 Б | сплит чистый (call/jp по именам) — см. docs/libc-split-asm-cases.md |
|
||
| stdio/dec_print.c | 3 | 176 Б | НЕ резать (общее тело); открытое решение: вариант «3 независимых цикла» — п. отложен |
|
||
|
||
Ожидаемый эффект: графические приложения −1–2 КБ, mouse/BIOS-text — сотни байт.
|
||
|
||
## П2. FILE* — отложенные баги и недостающее
|
||
|
||
Из шапки бывшего file.c («PROVISIONAL», stdio-review issues 3/4/5):
|
||
|
||
- [x] fwrite: короткая запись ставит _F_ERROR (issue 3) — сделано 2026-07-06
|
||
- [x] fgets(n=1): возвращает пустую строку по стандарту (issue 4) — сделано 2026-07-06
|
||
- [x] mode_to_flags: проверено — парсер сканирует весь хвост режима, «rb+» работает (issue 5, уже был исправлен)
|
||
- [x] **fprintf/vfprintf** — сделаны 2026-07-06 (vsprintf в статический 256-байтовый буфер + fwrite)
|
||
- [x] ungetc — 1-байтный putback через поле hold; работает и на stdin — сделано 2026-07-06
|
||
- [x] Буферизация FILE v2 — **реализован вариант B+** (2026-07-06): единый ленивый буфер BUFSIZ=512 на чтение и запись с автопереключением направления, статическая таблица OPEN_MAX=8 слотов, _fclosall через atexit, fflush(NULL) = все потоки. Дизайн: docs/file-buffering-design.md. Цена: filetest (использует всё) 7411→9929 Б _CODE; не-FILE программы не платят ничего. **Ждёт MAME-прогона: filetest, fdmax (лимит DSS), fbench (замер скорости)**
|
||
- [ ] fdopen/freopen/fclosall/fgetpos/fsetpos — по мере надобности (Solid-C категория C)
|
||
|
||
## П3. Solid-C совместимость — остатки (docs/solid_c_compatibility.md)
|
||
|
||
Phase 1 (алиасы) фактически закрыт — home/inp/outp/enable/disable, ms_*,
|
||
getc/putc, min/max, dec*/hex*, strlwr/strupr, cgets есть. Осталось:
|
||
|
||
- [ ] getdisk()/setdisk() — ESTEX $02 CURDISK / $01 CHDISK
|
||
- [ ] getdate/gettime/setdate/settime — обёртки над getdatetime/setdatetime
|
||
- [ ] seek/tell/ltell, setmem/movmem, isascii, abort(), div(), remove→unlink, _ffirst
|
||
- [ ] errno-константы Solid-C (EZERO/EINVFNC/…) как алиасы в errno.h
|
||
- [ ] `<sprinter_solid.h>` — зонтичный compat-заголовок
|
||
- [ ] обновить статусы/history в solid_c_compatibility.md (Phase 1 done)
|
||
|
||
Research (Phase 3): absread/abswrite (найти ESTEX READ_SECT/WRITE_SECT),
|
||
scanf-семейство (**в SDCC 4.5 z80 его НЕТ** — писать самим или задокументировать
|
||
отказ), brk/sbrk vs SDCC heap, isatty, ioctl (скорее скип).
|
||
|
||
## П4. Недостающие POSIX-мелочи вне Solid-C списка
|
||
|
||
- [ ] **rename()** — в gap-анализе отсутствует, ESTEX почти наверняка имеет
|
||
RENAME (~$0F, рядом с DELETE $0E) — проверить по докам ESTEX и добавить
|
||
- [ ] isatty(fd) — тривиально (fd<0/флаги)
|
||
|
||
## П5. Заголовки и гигиена сборки
|
||
|
||
- [ ] Аудит затенения SDCC-заголовков: stdlib.h уже на `#include_next`;
|
||
stdio.h/time.h — полные замены (задокументировать контракт «что обязаны
|
||
объявлять»); подумать про собственный string.h (include_next + strlwr/
|
||
strupr из sprinter_compat.h)
|
||
- [ ] lib/build: wildcard не удаляет stale .rel при удалении исходника —
|
||
либо чистка в Makefile (сверка списка), либо привычка `make clean`
|
||
после переименований (это уже укусило: старый file.rel лежал в build)
|
||
- [ ] Включить extra-тесты (conio2, dec_test, gets, hello2, simple, stest2,
|
||
winrest, bios_text, text_palette, gfx_dbuf, mdview2) в top-level
|
||
TESTS/APPS — иначе `make all` их не собирает и их baseline протухает
|
||
(уже дало ложные «+17 Б» при сравнении)
|
||
- [ ] Размерный регресс-тест: скрипт сравнения _CODE по .map с эталоном
|
||
(ловить случайные разжирения при правках libc)
|
||
|
||
## П6. Верификация после сплита
|
||
|
||
- [ ] `make floppy` + прогон в MAME ключевых тестов (conio, filetest, ptime,
|
||
stattest, mouse, gfx_demo) — линковка прошла, но поведение надо
|
||
подтвердить на эмуляторе
|
||
- [ ] Потом на железе (mdview2 и так ждёт проверки на железе — совместить)
|
||
|
||
## П7. Документация
|
||
|
||
- [ ] docs/libc-reference.md — сводный справочник API (по заголовкам:
|
||
сигнатура + 1 строка описания + особенности ABI); сейчас знание
|
||
размазано по memory/ и комментариям
|
||
- [ ] TODO.md: этапы 5/6/8 закрыты — перенести в history, добавить «этап 9 —
|
||
libc-оптимизация» (этот план)
|
||
- [ ] В CLAUDE.md/README зафиксировать правила libc: 1 ф-я = 1 модуль,
|
||
internal `_`-модули, русские комментарии, без `= 0`, asm-правила
|
||
(docs/libc-split-asm-cases.md)
|
||
|
||
## П8. Смежное (не libc, из TODO.md — чтобы не потерялось)
|
||
|
||
- auto-banking Phase 1 (toolchain/auto_bank.py) — когда проект перерастёт ~30 КБ
|
||
- IM2 ISR v2 (docs/im2_isr_design.md) — отложено решением 2026-06-01
|
||
- font-quad для 640×256 (per-cell палитра)
|
||
- factoring parse_argv из crt0/crt0_banked в общий argv.s
|
||
- check_banks.py: разбивка code/const/bss per bank (косметика)
|
||
|
||
---
|
||
|
||
## Предлагаемый порядок
|
||
|
||
1. **П1-лайт**: io/env/errno/atexit/minmax/mem/dir/fsdir (мелкие, час работы,
|
||
выигрыш для всех CLI-приложений) + mouse + bios/text.
|
||
2. **П6**: MAME-смоук — подтвердить, что сплит ничего не сломал в рантайме,
|
||
до того как менять что-то ещё.
|
||
3. **П1-gfx**: разбор графики (самый большой кусок, отдельный заход).
|
||
4. **П2**: баги FILE* (3 шт.) + fprintf + ungetc.
|
||
5. **П3/П4**: solid-c остатки + rename/isatty.
|
||
6. **П5/П7**: гигиена сборки и документация — фоном, по кусочку.
|