JMÉNO¶

sysconf - získej konfigurační informace za běhu

POUŽITͶ

#include <unistd.h>

long sysconf(int name);

POPIS¶

POSIX dovoluje aplikaci v čase překladu, nebo běhu aplikace, testovat, zda jsou určité volby podporovány, nebo jaké jsou hodnoty těchto konfigurovatelných systémových parametrů.

V čase překladu se toto děje pomocí vložení <unistd.h> a/nebo <limits.h> a testování hodnot příslušných maker.

V čase běhu, se můžeme dotazovat na numerické hodnoty použitím funkce sysconf(). Pokud se budeme dotazovat na hodnoty, které jsou závislé na souborovém systému, je vhodné použít volání fpathconf(3) nebo pathconf(3). Pro dotazování se na hodnoty řetězců je vhodné použít confstr(3).

Hodnoty získané z těchto funkcí jsou systémové konstanty. Nemění se po dobu života procesu.

Pro jednotlivé proměnné existuje obvykle konstanta _POSIX_FOO definovaná v <unistd.h>. Pokud definované nejsou, můžeme se dotazovat v době běhu programu. Pokud je hodnota definována jako -1, potom není podporována. Pokud je definováno na hodnotu 0, pak dané funkce a hlavičky existují, nicméně musíme se dotazovat v době běhu programu, jaký stupeň podpory je k dispozici. Pokud je hodnota definována jinak než 0 nebo -1 pak je nastaveni podporováno. Obvykle hodnota (jako například 200112L) signalizuje rok a měsíc POSIXové revize popisující dané nastavení. Glibc používá hodnotu 1 k signalizace podpory, protože POSIX standard ještě stále nebyl zapracován do Glibc. Argumentem sysconf() bude _SC_FOO. Pro seznam voleb viz posixoptions(7).

Pro proměnné, nebo limity obvykle existuje konstanta _FOO, která je definována v <limits.h>, nebo _POSIX_FOO, kterou lze nalézt v <unistd.h>. Konstanta nebude definována, pokud není specifikován limit. Pokud je konstanta definována, definuje zaručenou hodnotu a dokonce může být podporována i vyšší hodnota. Pokud chce aplikace využívat hodnot, které se mohou měnit mezi jednotlivými systémy, může být volán sysconf(). Argumentem sysconf() bude _SC_FOO.

NÁVRATOVÉ HODNOTY¶

The return value of sysconf() is one of the following:

• On error, -1 is returned and errno is set to indicate the cause of the error (for example, EINVAL, indicating that name is invalid).
• If name corresponds to a maximum or minimum limit, and that limit is indeterminate, -1 is returned and errno is not changed. (To distinguish an indeterminate limit from an error, set errno to zero before the call, and then check whether errno is nonzero when -1 is returned.)
• If name corresponds to an option, a positive value is returned if the option is supported, and -1 is returned if the option is not supported.
• Otherwise, the current value of the option or limit is returned. This value will not be more restrictive than the corresponding value that was described to the application in <unistd.h> or <limits.h> when the application was compiled.

CHYBOVÉ STAVY¶

EINVAL

name je neplatný.

ATRIBUTY¶

Vysvětlení pojmů použitých v této části viz attributes(7).

SPLŇUJE STANDARDY¶

POSIX.1-2001, POSIX.1-2008.

CHYBY¶

Je velmi těžké používat ARG_MAX protože není specifikováno, jaké množství paměti je při volání exec(3) spotřebováno uživatelskými proměnnými v prostředí.

Některé hodnoty mohou být příliš velké; nejsou vhodné k alokování paměti.

DALŠÍ INFORMACE¶

bc(1), expr(1), getconf(1), locale(1), confstr(3), fpathconf(3), pathconf(3), posixoptions(7)

TIRÁŽ¶

Tato stránka je součástí projektu Linux man-pages v5.10. Popis projektu a informace o hlášení chyb najdete na https://www.kernel.org/doc/man-pages/.

PŘEKLAD¶

Překlad této příručky do španělštiny vytvořili Pavel Heimlich <tropikhajma@gmail.com>

Tento překlad je bezplatná dokumentace; Přečtěte si GNU General Public License Version 3 nebo novější ohledně podmínek autorských práv. Neexistuje ŽÁDNÁ ODPOVĚDNOST.

Pokud narazíte na nějaké chyby v překladu této příručky, pošlete e-mail na adresu translation-team-cs@lists.sourceforge.net.