sub-rotina sysconfig

Propósito

Fornece um serviço para controle de configuração do sistema / kernel.

Biblioteca

Biblioteca C Padrão (libc.a)

Sintaxe

#include <sys/types.h>
#include <sys/sysconfig.h>
int sysconfig ( Cmd,  Parmp,  Parmlen)
int Cmd;
void *Parmp;
int Parmlen;

Descrição

A subroutine sysconfig é usada para customizar o sistema operacional. Esta subroutine fornece um meio de carregar, descarregar e configurar extensões do kernel. Essas extensões do kernel podem ser adicionais serviços kernel, chamadas de sistema, drivers de dispositivo, ou Sistemas de arquivo em Sistema operacional e gerenciamento de dispositivos. A subroutine sysconfig também fornece a capacidade de ler e configurar parâmetros de funcionamento de tempo de execução do sistema.

O uso da subroutina sysconfig requer privilégio apropriado.

A operação particular que o subroutine sysconfig fornece é definida pelo valor do parâmetro Cmd . São definidas as seguintes operações:

Item Descrição
SYS_KLOAD (Operação SYS_KLOAD sysconfig) Carrega um arquivo de objeto de extensão do kernel para a memória do kernel.
SYS_SINGLELOAD (Operação do sysconfig do SYS_SINGLELOAD ) Carrega um arquivo de objeto de extensão do kernel apenas se ele ainda não estiver carregado.
SYS_QUERYLOAD (Operação SYS_QUERYLOAD sysconfig) Determina se um arquivo objeto do kernel especificado é carregado.
SYS_KULOAD (Operação sysconfig do SYS_KULOAD) Descarrega um arquivo objeto do kernel anteriormente carregado.
SYS_QDVSW (Operação SYS_QDVSW sysconfig) Verifica o status de uma entrada de comutador de dispositivo na tabela de comutação do dispositivo.
SYS_CFGDD (Operação SYS_CFGDD sysconfig) Chama a rotina de configuração do driver de dispositivo especificado (módulo de entrada do módulo).
SYS_CFGKMOD (Operação de sysconfig SYS_CFGKMOD) Chama o módulo especificado em seu ponto de entrada do módulo para fins de configuração.
SYS_GETPARMS (Operação SYS_GETPARMS sysconfig) Retorna uma estrutura contendo os valores atuais de parâmetros do sistema de tempo de execução encontrados na estrutura var .
SYS_SETPARMS (Operação SYS_SETPARMS sysconfig) Configura parâmetros do sistema de tempo de execução a partir de uma estrutura fornecida pelo caller.
SYS_GETLPARINFO (Operação SYS_GETLPAR_INFO sysconfig) Copia as informações da partição lógica do sistema em um buffer alocado pelo usuário.

Além disso, a sinalização SYS_64BIT pode ser bitwise ou ' ed com o parâmetro Cmd (se o parâmetro Cmd for SYS_KLOAD ou SYS_SINGLELOAD). Para extensões do kernel, isso indica que a extensão do kernel não exporta 64-bit chamadas de sistema, mas que todas as chamadas de sistema 32-bit também funcionam para 64-bit aplicativos. Para os drivers de dispositivo, isso indica que o driver do dispositivo pode ser usado por 64-bit aplicativos.

Loader Symbol Binding Support explica o suporte de ligação de símbolo fornecido ao carregar arquivos de objetos do kernel.

Parâmetros

Item Descrição
Cmd Especifica a função que a subroutina sysconfig deve executar.
Parmp Especifica uma estrutura fornecida pelo usuário.
Parmlen Especifica o comprimento da estrutura fornecida pelo usuário indicado pelo parâmetro Parmp .

Valores De Retorno

Essas operações sysconfig retornam um valor de 0 após a conclusão bem-sucedida da subroutine. Caso contrário, um valor de -1 é retornado e a variável global errno é definida para indicar o erro.

Qualquer operação sysconfig necessitando de uma estrutura a partir do caller falha se a estrutura não estiver inteiramente dentro da memória endereçável pelo processo de chamada. Um valor de retorno de -1 é passado de volta e a variável global errno é definida como EFAULT.