Skip to content

Appels système GaspardOS x64

English

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.