Scroll to navigation

SYSCTL(2) Manual do Programador do Linux SYSCTL(2)

NOME

sysctl - lê/escreve parâmetros do sistema

SINOPSE

#include <unistd.h>
#include <linux/sysctl.h>
int _sysctl(struct __sysctl_args *args);

DESCRIÇÃO

This system call no longer exists on current kernels! See NOTES.

A chamada _sysctl() lê e/ou escrever parâmetros do kernel. Por exemplo, o nome da máquina, ou o número máximo de arquivos abertos. O argumento tem a forma


struct __sysctl_args {

int *name; /* integer vector describing variable */
int nlen; /* length of this vector */
void *oldval; /* 0 or address where to store old value */
size_t *oldlenp; /* available room for old value,
overwritten by actual size of old value */
void *newval; /* 0 or address of new value */
size_t newlen; /* size of new value */ };

Esta chamada faz um busca numa árvore de estrutura, possivelmente parecida com uma árvore de diretório sob /proc/sys, e se o item requisitado é encontrado é chamada alguma rotina apropriada para ler ou modificar o valor.

VALOR DE RETORNO

Em caso de sucesso _sysctl() devolve 0. Caso contráio, -1 é devolvido e errno é selecionado adequadamente.

ERROS

No search permission for one of the encountered "directories", or no read permission where oldval was nonzero, or no write permission where newval was nonzero.
O pedido perguntou pelo valor anterior selecionando oldval como não nulo, mas permitido zero espaço em oldlenp.
name não foi encontrado.

VERSÕES

This system call first appeared in Linux 1.3.57. It was removed in Linux 5.5; glibc support was removed in version 2.32.

DE ACORDO COM

Esta chamada é específica do Linux e não deve ser usada em programas que pretendem ser portáveis. . Ela é originária do BSD 4.4. Somente o Linux tem o espelho /proc/sys, e os esquemas de nomeamento de objetos diferem entro o Linux e o 4.4BSD, mas a declaração da função sysctl() é a mesma em ambos.

NOTAS

Use of this system call was long discouraged: since Linux 2.6.24, uses of this system call result in warnings in the kernel log, and in Linux 5.5, the system call was finally removed. Use the /proc/sys interface instead.

Note that on older kernels where this system call still exists, it is available only if the kernel was configured with the CONFIG_SYSCTL_SYSCALL option. Furthermore, glibc does not provide a wrapper for this system call, necessitating the use of syscall(2).

BUGS

The object names vary between kernel versions, making this system call worthless for applications.

Nem todos objetos disponíveis são documentados adequadamente.

Ainda não é possível mudar sistema operacional escrevendo /proc/sys/kernel/ostype.

EXEMPLOS

#define _GNU_SOURCE
#include <unistd.h>
#include <sys/syscall.h>
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
#include <linux/sysctl.h>
int _sysctl(struct __sysctl_args *args );
#define OSNAMESZ 100
int
main(void)
{

struct __sysctl_args args;
char osname[OSNAMESZ];
size_t osnamelth;
int name[] = { CTL_KERN, KERN_OSTYPE };
memset(&args, 0, sizeof(args));
args.name = name;
args.nlen = sizeof(name)/sizeof(name[0]);
args.oldval = osname;
args.oldlenp = &osnamelth;
osnamelth = sizeof(osname);
if (syscall(SYS__sysctl, &args) == -1) {
perror("_sysctl");
exit(EXIT_FAILURE);
}
printf("This machine is running %*s\n", osnamelth, osname);
exit(EXIT_SUCCESS); }

VEJA TAMBÉM

proc(5)

COLOFÃO

Esta página faz parte da versão 5.13 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

TRADUÇÃO

A tradução para português brasileiro desta página man foi criada por André Luiz Fassone <lonely_wolf@ig.com.br> e Marcelo Pereira da Silva <marcelo@pereira.com>

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.

22 março 2021 Linux