serviço do kernel ufdcreate

Propósito

Aloca e inicializa um descritor de arquivo.

Sintaxe

#include <fcntl.h>
#include <sys/types.h>
#include <sys/file.h>

int ufdcreate (flags, ops, datap, type, fdp, cnp)

Parâmetros

Descrição

O serviço kernel ufdcreate fornece uma interface de arquivo para extensões do kernel. Extensões do kernel usam este serviço para criar um descritor de arquivo e par de estrutura de arquivos. Também, este serviço permite extensões do kernel para fornecer suas próprias chamadas de sistema baseado em descritor de arquivos, permitindo a leitura / gravação, ioctl, select, fstat e fechamento de operações em objetos fora do sistema de arquivos. Os serviços do kernel ufdcreate não requerem a extensão para entender ou adequar-se aos requisitos de sincronização do sistema de arquivos lógico (IFT).

O serviço kernel ufdcreate fornece um descritor de arquivo para o caller e cria a estrutura de arquivo subjacente. O ouvinte deve incluir ponteiros para rotinas fornecidas pelo subsistema para as operações de leitura / gravação, ioctl, select, fstat e fechamento. Se alguma das operações não for necessária pelo subsistema de chamada, então o ouvinte deverá fornecer um ponteiro para um valor errno apropriado. Geralmente, o valor EOPNOTSUPP é usado para esta finalidade. Veja "Operações de Arquivo" para obter informações sobre os requisitos para as rotinas fornecidas pelo subsistema.

Removendo um Descritor de Arquivo

Não há operação correspondente para remover um descritor de arquivo (e as estruturas atendidas) criado pelo serviço kernel ufdcreate . Para remover um descritor de arquivo, use uma chamada para a subroutine fechar . A subroutine fechar pode ser chamada de uma rotina ou de dentro da extensão kernel ou kernel. Se o fechamento não for chamado, o arquivo será fechado quando o processo sair.

Uma vez que uma chamada é feita ao serviço kernel ufdcreate , o descritor de arquivo é considerado aberto antes da chamada para o serviço retornar. Quando uma subroutine fechar ou saída é chamada, a operação de arquivo próximo especificada na chamada para a interface ufdcreate é chamada.

Operações de Arquivo

O serviço kernel ufdcreate permite extensões do kernel para fornecer suas próprias chamadas de sistema baseado em descritor de arquivos, permitindo a leitura / gravação, ioctl, select, fstat e fechamento de operações em objetos fora do sistema de arquivos. A estrutura fileops definida no arquivo sys/file.h fornece interfaces para essas rotinas

leitura / gravação Requisitos

A operação de leitura / gravação gerencia entrada e saída para o objeto especificado pelo parâmetro fp . As ações realizadas por esta operação são dependentes do tipo de objeto. A sintaxe para a operação é a seguinte:

#include <sys/types.h>
#include <sys/uio.h>

int (*fo_rw) (fp, rw, uiop, ext)

struct file *fp;
enum uio_rw rw;
struct uio *uiop;
int ext;

Os parâmetros possuem os seguintes valores:

Se bem-sucedida, a operação fo_rw retorna um valor de 0. Um valor de retorno não zero deve ser programado para indicar um erro. Consulte o arquivo sys/errno.h para obter uma lista de valores possíveis

requisitos do ioctl

A operação ioctl fornece processamento de comando especial dependente de objetos. A subroutine ioctl executa uma variedade de operações de controle sobre o objeto associado à estrutura de arquivo aberta especificada. Essa subroutine é tipicamente usada com o caractere ou bloquear arquivos especiais e retorna um erro para arquivos comuns.

A operação de controle fornecida pela operação ioctl é específica para o objeto que está sendo abordado, assim como o tipo de dados e o conteúdo do parâmetro arg .

A sintaxe para a operação ioctl é a seguinte:

#include <sys/types.h>
#include <sys/ioctl.h>

int (*fo_ioctl) (fp, cmd, arg, ext, kflag)

struct file *fp;
int cmd, ext, kflag;
caddr_t arg; 

Os parâmetros possuem os seguintes valores:

Se bem-sucedida, a operação fo_ioctl retorna um valor de 0. Para erros, a operação fo_ioctl deve retornar um valor de retorno diferente de zero para indicar um erro. Consulte o arquivo sys/errno.h para obter a lista de valores possíveis

selecionar Requisitos

A operação select realiza uma operação select no objeto especificado pelo parâmetro fp . A sintaxe para esta operação é a seguinte:

#include <sys/types.h>

int (*fo_select) (fp, corl, reqevents, rtneventsp, notify)

struct file *fp;
int corl;
ushort reqevents, *rtneventsp;
void (notify) ();

Os parâmetros possuem os seguintes valores:

Se bem-sucedida, a operação fo_select retorna um valor de 0. Esta operação deve retornar um valor de retorno diferente de zero para indicar um erro. Consulte o arquivo sys/errno.h para obter a lista de valores possíveis

fstat Requisitos

A operação fstat preenche uma estrutura atributo . Dependendo do tipo de objeto especificado pelo parâmetro fp , muitos campos na estrutura podem não ser aplicáveis. O valor repassado a partir desta operação é dependente tanto do tipo de objeto quanto do que qualquer rotina que entenda o tipo está esperando. A sintaxe para esta operação é a seguinte:

#include <sys/types.h>

int (*fo_fstat) (fp, sbp)

struct file *fp;
struct stat *sbp;

Os parâmetros possuem os seguintes valores:

Se bem-sucedida, a operação fo_fstat retorna um valor de 0. Um valor de retorno não zero deve ser programado para indicar um erro. Consulte o arquivo sys/errno.h para obter a lista de valores possíveis

fechar Requisitos

A operação de fechamento invalida o acesso de rotina aos objetos especificados pelo parâmetro fp e libera quaisquer dados associados a esse acesso. Esta operação é chamada a partir do código subroutine fechar quando a contagem de uso da estrutura arquivo é decretada para 0. Por exemplo, se houver vários acessos a um objeto (criado pelo dup, garfoou outra operação específica do subsistema), o subroutine fechar chama a operação de fechamento quando ele determina que não há acesso restante através da estrutura arquivo sendo fechada.

Um descritor de arquivo é considerado aberto uma vez que um descritor de arquivo e a estrutura arquivo foram configurados pelo IFT. A operação de fechamento de arquivo é chamada sempre que um fechamento ou saída é especificado. Como resultado, a operação de fechamento deve ser capaz de fechar um objeto que não esteja totalmente aberto, dependendo do que o ouvinte fez antes que a estrutura arquivo foi inicializada.

A sintaxe para a operação de fechamento é a seguinte:

#include <sys/file.h>

int (*fo_close) (fp)
struct file *fp;

O parâmetro é:

Se bem-sucedida, a operação fo_close retorna um valor de 0. Esta operação deve retornar um valor de retorno diferente de zero para indicar um erro. Consulte o arquivo sys/errno.h para obter a lista de valores possíveis

Ambiente de Execução

O serviço kernel ufdcreate pode ser chamado a partir do ambiente de processo apenas.

Valores De Retorno

Se o serviço kernel ufdcreate tiver sucesso, ele retorna um valor de 0. Se o serviço do kernel falhar, ele retorna um valor não zero e configura a variável global errno .

Códigos De Erro

O serviço de kernel ufdcreate falha se ocorrer um ou mais dos seguintes erros: