2013-03-04 3 views
6

Я использую драйвер персонального устройства Linux.Что такое аргументы «struct file_operations»?

В файле заголовка linux/fs.h перечислены файловые_операции без имен аргументов.

например.

struct file_operations { 
    struct module *owner; 
    loff_t (*llseek) (struct file *, loff_t, int); 
    ssize_t (*read) (struct file *, char __user *, size_t, loff_t *); 
    ssize_t (*write) (struct file *, const char __user *, size_t, loff_t *); 
    ssize_t (*aio_read) (struct kiocb *, const struct iovec *, unsigned long, loff_t); 
    ssize_t (*aio_write) (struct kiocb *, const struct iovec *, unsigned long, loff_t); 
    int (*readdir) (struct file *, void *, filldir_t); 
    unsigned int (*poll) (struct file *, struct poll_table_struct *); 
    long (*unlocked_ioctl) (struct file *, unsigned int, unsigned long); 
    long (*compat_ioctl) (struct file *, unsigned int, unsigned long); 
    int (*mmap) (struct file *, struct vm_area_struct *); 
    int (*open) (struct inode *, struct file *); 
    int (*flush) (struct file *, fl_owner_t id); 
    int (*release) (struct inode *, struct file *); 
    int (*fsync) (struct file *, loff_t, loff_t, int datasync); 
    int (*aio_fsync) (struct kiocb *, int datasync); 
    int (*fasync) (int, struct file *, int); 
    int (*lock) (struct file *, int, struct file_lock *); 
    ssize_t (*sendpage) (struct file *, struct page *, int, size_t, loff_t *, int); 
    unsigned long (*get_unmapped_area)(struct file *, unsigned long, unsigned long, unsigned long, unsigned long); 
    int (*check_flags)(int); 
    int (*flock) (struct file *, int, struct file_lock *); 
    ssize_t (*splice_write)(struct pipe_inode_info *, struct file *, loff_t *, size_t, unsigned int); 
    ssize_t (*splice_read)(struct file *, loff_t *, struct pipe_inode_info *, size_t, unsigned int); 
    int (*setlease)(struct file *, long, struct file_lock **); 
    long (*fallocate)(struct file *file, int mode, loff_t offset, 
       loff_t len); 
}; 

Где документация, которая сообщает мне, что такое каждый аргумент? Некоторые из них очевидны, но некоторые - нет. Я предпочитаю ссылаться на официальную документацию, если могу, но я просто не могу ее найти.

например.

int (*fsync) (struct file *, loff_t, loff_t, int datasync); 

Существует два аргумента loff_t. Откуда я знаю, что они делают?

Я читал книгу драйверов устройства, но я не могу найти никаких документов, объясняющих, для чего нужны аргументы. Некоторые из аргументов также изменились с момента написания LDD3.

ответ

5

Книга LDD3 очень полезна, чтобы понять общую картину, но она не поможет в деталях (это для ядра 2.6.10, а пока мы идем к 3.9). kernelnewbies drivers page - это, пожалуй, самый современный, всеобъемлющий ресурс. Для ежедневных изменений LWN регулярно комментирует изменения API и публикует более подробные обзоры новых функций. H-online содержит ряд статей, в которых подробно описаны изменения с версии ядра до версии ядра, ссылки на обсуждения и исправления.

+0

Это мои обычные места для поиска. Я пишу и документирую, как писать драйвер устройства для некоторых других людей, и я полностью потеряю, чтобы рассказать им, как найти эту информацию. Я пытаюсь завоевать сердца и умы и показать им, что Linux имеет ценность, но мне неловко, когда я не могу показать им полную или обновленную документацию для одной из самых ценных структур для драйверов устройств! Я знаю, чтобы посмотреть на другие драйверы и попытаться просто «разобраться», но я не думаю, что это достаточно хорошо. –

+0

К сожалению, так оно и работает. Ближайшей к документации, которую вы ищете, был LDD в его расцвете, но (как свидетельствует «3») система, которая пыталась быстро описать изменения, и она не отставала. Возможно, лучший способ выйти из привязки - просто выкопать в kernelnewbies и обновить их описание? – vonbrand

+0

Я понял, что может быть так, подумал, что стоит проверить мою последнюю попытку. Я помню, что использовал LDD3, когда 2.4 был постепенно отключен для систем 2.6. Это было незадолго до того, как я получал «устаревшие» предупреждения при переносе старых драйверов устройств, хотя я следил за примерами в книге. Мне не приходилось делать разработку драйверов устройств Linux в течение нескольких лет, поэтому я нахожусь на этапе запуска и обучения на рабочем месте. Я надеялся, что это уже не так. –

1

Мне пришлось реализовать мой первый Linux-драйвер некоторое время назад. Безусловно, самое лучшее, что я могу сделать, это загрузить источник ядра для версии, против которой вы работаете. В исходном дереве ядра есть каталог под названием/Documentation. Я бы начал там, последний раз, когда я проверил, это «Официальная документация» для ядра.

Это, как говорится, после того, как у вас есть исходный код, на самом деле нет лучшей документации, чем чтение кода и видение того, что оно используется. Для таких вещей я просмотрел/drivers/fs/и нашел пример того, где эта структура используется, и посмотреть, как они ее используют.

Смежные вопросы