• Návody
• Linux
• Úvod do vývoje ovladačů
• Kostra ovladače
• Operace read() a write()

Operace read() a write()

ssize_t read(struct file * filp, char __user * buff, size_t count, loff_t * ppos);
ssize_t read(struct file * filp, const char __user * buff, size_t count, loff_t * ppos);

• filp - je ukazatel na již dříve popsanou strukturu file.
• buff - je ukazatel na data v uživatelském prostoru.
• count - určuje množství dat, která se mají přenášet (v bytech).
• ppos - je ukazatel na na pozici v souboru.

Přenos dat z/do uživatelského prostoru

long copy_to_user(void __user * to, const void * from, unsigned long count);
long copy_from_user(void * to, const void __user * from, unsigned long count);

int get_user(var, ptr); 
int put_user(var, ptr);

int access_ok(type, addr, size);

Pozice v souboru zařízení

Návratová hodnota

• 0 - pokud nedošlo k přenosu dat.
• > 0 (kladnou hodnotu) - pokud se podařilo přenést data - ta pak určuje počet přenesených bytů.
• < 0 (zápornou hodnotu) - např. -EFAULT, která udává kód chyby (EFAULT) záporně. Tento kód chyby jádro uloží do proměnné errno přístupné v uživatelském prostoru a zajistí, že návratová hodnota systémového volání bude -1. Uživatelská aplikace se tak jen dozví, že systémové volání selhalo. Samotný kód chyby si musí vyčíst z proměnné errno.

Obecné zásady implementace operace read() a write()

• Pokud dojde během přenosu k chybě, tak operace read() či write() musí vrátit počet úspěšně vyčtených/zapsaných dat. Chybu (obvykle -EFAULT), která nastala si musí zapamatovat a vrátit ji při dalším volání, které ihned selže.
• Operace read() a write() mohou vyčíst/zapsat méně než bylo požadováno v parametru count. Uživatelský program pak může opakovat volání těchto operací.
• Jestliže operace read() vrátí 0, pak nebyli vyčtena žádná data a buffer v uživatelském prostoru musí zůstat nedotčen. Jinými slovy bylo dosaženo konce souboru.
• Pokud je hodnota parametru count = 0, pak operace vrátí také 0 - nic nebylo vyčteno/zapsáno.
• Po přenosu dat je nutné aktualizovat pozici v souboru přes ukazatel ppos.
• Jestliže dojde k chybě, tak se obvykle vrací -EFAULT (špatná adresa, např. neplatný ukazatel na buffer) nebo -EINTR (přerušení systémového volání).

Operace read() a write() v modulu dskel

1static ssize_t dskel_read(struct file * file_ptr,
2                                                      char __user * data_ptr, size_t data_size,
3                                                      loff_t * pos_ptr)
4{
5      pr_alert("dskel_read(): done\n");
6​
7      return 0;
8}

1static ssize_t dskel_write(struct file * file_ptr,
2                                                      const char __user * data_ptr, size_t data_size,
3                                                      loff_t * pos_ptr)
4{
5      pr_alert("dskel_write(): %d\n", data_size);
6​
7      return data_size;
8} 

$ echo nic > /dev/dskel

$ dmesg | tail