Appels système GaspardOS x64¶
GaspardOS a longtemps utilisé des appels système spécifiques. Le portage de newlib a conduit à rapprocher les services de fichiers et de réseau des interfaces Unix pour faciliter le portage des programmes C et C++. Cela ne signifie pas que GaspardOS implémente toute la norme POSIX ni l'ABI des appels système Linux, je suis pas fan de cette idee....
Cette page concerne exclusivement x86-64, l'ABI System V AMD64 et le modèle
LP64 : les pointeurs, long et size_t font 64 bits, et wchar_t fait
32 bits. L'interface i686 historique et int 0x80 sont hors de ce périmètre.
Quelle interface utiliser ?¶
Pour les opérations habituelles, utiliser newlib : fopen, open, read,
write, stat, getcwd ou chdir. La libc adapte les chemins, les indicateurs
et les erreurs aux services du noyau. Écrire de l'assembleur n'est pas nécessaire.
Les wrappers C GO64_* exposent l'interface native, notamment les fenêtres,
le rendu et le lancement de processus. Les bindings C++ et Fortran les utilisent
également.
Convention d'appel native¶
Les wrappers exécutent SYSCALL avec le numéro dans RAX et jusqu'à six
arguments dans RDI, RSI, RDX, R10, R8 et R9. Le résultat revient
dans RAX. L'instruction modifie RCX et R11 ; le transport déclare aussi
les effets sur la mémoire et les indicateurs du processeur.
Les services qui retournent une valeur utilisent int64_t : une valeur
négative signale une erreur native. GO64_exit ne retourne pas. Newlib traduit
les erreurs vers ses propres valeurs de errno et le contrat de chaque fonction
C : tester fopen contre NULL, open contre -1, etc. Les erreurs natives
ne doivent pas être confondues avec les valeurs de errno de newlib.
Les pointeurs désignent la mémoire utilisateur du processus appelant.
Respecter les tailles et l'alignement des structures du header x64 ; ne pas
utiliser -fshort-wchar ni forcer leur empaquetage.
Tableau des appels x64¶
Site/refresh_sources.py collecte les numéros et signatures depuis le header
des wrappers natifs. Le tableau couvre les services exposés par les bindings
de ce dépôt, pas les extensions privées d'autres composants.
45 appels exposés par les wrappers x64 du dépôt.
| Numéro | Wrapper C |
|---|---|
| 0 | int64_t GO64_ticks(void) |
| 1 | int64_t GO64_console_write(const void* buffer, uint64_t size) |
| 2 | int64_t GO64_yield(void) |
| 3 | void GO64_exit(void) |
| 4 | int64_t GO64_alloc(uint64_t size) |
| 5 | int64_t GO64_free(void* pointer) |
| 100 | int64_t GO64_fs_open(const wchar_t* path, uint64_t flags) |
| 101 | int64_t GO64_fs_close(int64_t fd) |
| 102 | int64_t GO64_fs_read(int64_t fd, void* buffer, uint64_t size) |
| 103 | int64_t GO64_fs_write(int64_t fd, const void* buffer, uint64_t size) |
| 104 | int64_t GO64_fs_seek(int64_t fd, int64_t offset, uint64_t origin) |
| 105 | int64_t GO64_fs_stat(const wchar_t* path, GO64_FSInfo* info) |
| 106 | int64_t GO64_fs_fstat(int64_t fd, GO64_FSInfo* info) |
| 107 | int64_t GO64_fs_mkdir(const wchar_t* path) |
| 108 | int64_t GO64_fs_unlink(const wchar_t* path) |
| 109 | int64_t GO64_fs_rmdir(const wchar_t* path) |
| 110 | int64_t GO64_fs_truncate(int64_t fd, uint64_t size) |
| 111 | int64_t GO64_fs_readdir(int64_t fd, GO64_FSInfo* info) |
| 112 | int64_t GO64_fs_rename(const wchar_t* oldpath, const wchar_t* newpath) |
| 113 | int64_t GO64_fs_fcntl(int64_t fd, uint64_t command, uint64_t flags) |
| 120 | int64_t GO64_socket(uint64_t family, uint64_t type, uint64_t protocol) |
| 121 | int64_t GO64_bind(int64_t fd, const GO64_SocketAddress* address, uint64_t address_size) |
| 122 | int64_t GO64_listen(int64_t fd, int64_t backlog) |
| 123 | int64_t GO64_accept(int64_t fd, GO64_SocketAddress* address, uint32_t* address_size) |
| 124 | int64_t GO64_connect(int64_t fd, const GO64_SocketAddress* address, uint64_t address_size) |
| 125 | int64_t GO64_send(int64_t fd, const void* buffer, uint64_t size, uint64_t flags) |
| 126 | int64_t GO64_recv(int64_t fd, void* buffer, uint64_t size, uint64_t flags) |
| 127 | int64_t GO64_sendto(int64_t fd, const void* buffer, uint64_t size, uint64_t flags, const GO64_SocketAddress* address, uint64_t address_size) |
| 128 | int64_t GO64_recvfrom(int64_t fd, void* buffer, uint64_t size, uint64_t flags, GO64_SocketAddress* address, uint32_t* address_size) |
| 129 | int64_t GO64_getsockname(int64_t fd, GO64_SocketAddress* address, uint32_t* address_size) |
| 130 | int64_t GO64_getpeername(int64_t fd, GO64_SocketAddress* address, uint32_t* address_size) |
| 131 | int64_t GO64_socket_close(int64_t fd) |
| 132 | int64_t GO64_log(const char* text) |
| 140 | int64_t GO64_window_create(const GO64_WindowOptions* options) |
| 141 | int64_t GO64_window_destroy(uint64_t window) |
| 142 | int64_t GO64_window_fill(uint64_t window, const GO64_Drawing* drawing) |
| 143 | int64_t GO64_window_text(uint64_t window, const GO64_Drawing* drawing) |
| 144 | int64_t GO64_window_event(uint64_t window, GO64_Event* event, uint64_t mode) |
| 145 | int64_t GO64_window_focus(uint64_t window) |
| 146 | int64_t GO64_window_blit(uint64_t window, const GO64_Blit* tile) |
| 150 | int64_t GO64_process_spawn(const void* image, uint64_t size, uint64_t argc, const char* const* argv) |
| 151 | int64_t GO64_process_read(void* buffer, uint64_t size) |
| 152 | int64_t GO64_process_status(void) |
| 153 | int64_t GO64_process_getcwd(char* buffer, uint64_t size) |
| 154 | int64_t GO64_process_chdir(const char* path) |
Groupes de services¶
| Numéros | Services |
|---|---|
| 0–5 | Ticks, sortie console, cession du processeur, terminaison et mémoire utilisateur. |
| 100–113 | Fichiers et dossiers : ouverture, lecture, écriture, position, métadonnées, création, suppression et renommage. |
| 120–131 | Sockets IPv4 TCP/UDP. |
| 132 | Journal du noyau. |
| 140–146 | Fenêtres, événements, dessin et copie de tuiles de pixels. |
| 150–152 | Lancement d'un enfant ELF64, lecture de sa sortie et nombre d'enfants non récupérés. |
| 153–154 | Lecture et changement du répertoire courant du processus. |
Les services de fichiers et de sockets peuvent retourner -11 pour demander
de céder le processeur puis de réessayer. Les fenêtres sont asynchrones :
attendre GO64_READY avant de dessiner. process_spawn retourne un jeton
de tâche, pas le code de sortie du programme enfant.
Newlib et le répertoire courant¶
Le backend partagé est compilé avec GASPARDOS_NEWLIB_X64 pour sélectionner
le transport x64. Les branches i686 présentes dans ce fichier ne changent pas
l'ABI décrite ici.
| Fonction newlib | Service ou adaptation x64 |
|---|---|
fopen, open |
Résolution UTF-8, conversion UTF-32, puis GO64_fs_open (100). |
read, write, close |
Services de fichiers ; traitement particulier pour la console. |
stat, mkdir, unlink, rmdir, rename |
Services de fichiers natifs correspondants. |
getcwd |
process_getcwd (153), adapté au contrat C, y compris getcwd(NULL, 0). |
chdir |
process_chdir (154), puis actualisation de l'état local de la libc. |
| Ouvertures relatives | Lecture du répertoire courant noyau avant construction du chemin absolu. |
Le noyau conserve un répertoire par processus. Les enfants en héritent une copie :
leur chdir ne modifie pas le parent. Sans parent, le dossier initial est
/IDEDISK0/. Le cd du terminal met à jour ce répertoire avant de lancer
un enfant. Sur un ancien noyau retournant -38 pour 153 ou 154, newlib conserve
son fonctionnement local historique.
Les appels fichiers natifs attendent toujours des chemins absolus UTF-32.
Les appels 153 et 154 utilisent UTF-8. process_getcwd retourne le nombre
d'octets copiés, NUL compris ; -34 indique un buffer trop petit.
process_chdir accepte les chemins relatifs, . et .., vérifie le dossier
et retourne zéro ou une erreur négative. Les chemins conservés se terminent
par / et occupent au maximum 4095 octets hors NUL.
Après cd /AHCIDISK0/projet dans le terminal, un programme lié avec la libc
mise à jour peut ouvrir les fichiers du projet par chemin relatif :
#include <stdio.h>
#include <unistd.h>
int main(void)
{
char cwd[4096];
if (!getcwd(cwd, sizeof(cwd))) { perror("getcwd"); return 1; }
printf("cwd: %s\n", cwd);
FILE *file = fopen("Vars.com", "r"); /* ou "Makefile" */
if (!file) { perror("Vars.com"); return 1; }
return fclose(file) == 0 ? 0 : 1;
}
Les exécutables existants doivent être reliés avec la bibliothèque mise à jour. GCC et les binutils n'ont pas besoin d'être recompilés pour ce changement.
Sources collectées¶
La collecte conserve les fichiers complets, y compris les branches i686 du
backend partagé. Cette page concerne leur compilation avec GASPARDOS_NEWLIB_X64.