sysconfig, Subroutine
Zweck
Stellt einen Service zur Steuerung der System-/Kernelkonfiguration bereit.
Bibliothek
Standard-C-Bibliothek (libc.a)
Syntax
Beschreibung
Die Subroutine sysconfig wird zum Anpassen des Betriebssystems verwendet. Diese Subroutine stellt eine Möglichkeit zum Laden, Entladen und Konfigurieren von Kernelerweiterungen bereit. Bei diesen Kernelerweiterungen kann es sich um zusätzliche Kernel-Services, Systemaufrufe, Einheitentreiber, oder Dateisysteme in Betriebssystem-und Einheitenmanagement. Die Subroutine sysconfig bietet auch die Möglichkeit, Systemlaufzeitbetriebsparameter zu lesen und festzulegen.
Die Verwendung der Subroutine sysconfig erfordert die entsprechende Berechtigung.
Die spezielle Operation, die die Subroutine sysconfig bereitstellt, wird durch den Wert des Parameters Cmd definiert. Die folgenden Operationen sind definiert:
| Element | Beschreibung |
|---|---|
| SYS_KLOAD (SYS_KLOAD-sysconfig-Operation) | Lädt eine Kernelerweiterungsobjektdatei in den Kernelspeicher. |
| SYS_SINGLELOAD (sysconfig-Operation SYS_SINGLELOAD) | Lädt eine Kernelerweiterungsobjektdatei nur, wenn sie noch nicht geladen ist. |
| SYS_QUERYLOAD (SYS_QUERYLOAD sysconfig-Operation) | Bestimmt, ob eine angegebene Kernelobjektdatei geladen wird. |
| SYS_KULOAD (sysconfig-Operation SYS_KULOAD) | Entlädt eine zuvor geladene Kernelobjektdatei. |
| SYS_QDVSW (SYS_QDVSW sysconfig-Operation) | Prüft den Status eines Einheitenswitcheintrags in der Einheitenswitchtabelle. |
| SYS_CFGDD (sysconfig-Operation SYS_CFGDD) | Ruft die angegebene Konfigurationsroutine des Einheitentreibers (Moduleingangspunkt) auf |
| SYS_CFGKMOD (sysconfig-Operation SYS_CFGKMOD) | Ruft das angegebene Modul an seinem Moduleingangspunkt zu Konfigurationszwecken auf |
| SYS_GETPARMS (sysconfig-Operation SYS_GETPARMS) | Gibt eine Struktur zurück, die die aktuellen Werte der Laufzeitsystemparameter enthält, die in der Struktur var gefunden werden. |
| SYS_SETPARMS (SYS_SETPARMS sysconfig Operation) | Legt Laufzeitsystemparameter aus einer vom Aufrufenden bereitgestellten Struktur fest. |
| SYS_GETLPARINFO (SYS_GETLPAR_INFO sysconfig-Operation) | Kopiert die LPAR-Systeminformationen in einen vom Benutzer zugeordneten Puffer. |
Darüber hinaus kann das Flag SYS_64BIT bitweise oder mit dem Parameter Bef angegeben werden (wenn der Parameter Bef auf SYS_KLOAD oder SYS_SINGLELADENgesetzt ist). Bei Kernelerweiterungen bedeutet dies, dass die Kernelerweiterung keine 64-Bit-Systemaufrufe exportiert, sondern dass alle 32-Bit-Systemaufrufe auch für 64-Bit-Anwendungen funktionieren. Gibt für Einheitentreiber an, dass der Einheitentreiber von 64-Bit-Anwendungen verwendet werden kann.
Im Abschnitt Unterstützung für Symbolbindung für Ladeprogramm wird die Unterstützung für Symbolbindungen erläutert, die beim Laden von Kernelobjektdateien bereitgestellt werden.
Parameter
| Element | Beschreibung |
|---|---|
| Befehl | Gibt die Funktion an, die die Subroutine sysconfig ausführen soll. |
| Parameter | Gibt eine vom Benutzer bereitgestellte Struktur an. |
| Parmlen | Gibt die Länge der vom Benutzer bereitgestellten Struktur an, die durch den Parameter Parmp angegeben wird |
Rückgabewerte
Diese sysconfig-Operationen geben nach erfolgreicher Beendigung der Subroutine den Wert 0 zurück. Andernfalls wird ein Wert von -1 zurückgegeben und die globale Variable errno wird gesetzt, um den Fehler anzuzeigen.
Jede sysconfig-Operation, die eine Struktur vom Aufrufenden erfordert, schlägt fehl, wenn sich die Struktur nicht vollständig innerhalb des vom aufrufenden Prozess adressierbaren Speichers befindet. Ein Rückgabewert von -1 wird zurückgegeben und die globale Variable errno wird auf EFAULT gesetzt.