Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../.././../../../usr/man/man9f/drv_getparm.9f
Real path: /usr/share/man/man9f/drv_getparm.9f
Zurück

'\" te .\" Copyright (c) 2009, 2020, Oracle and/or its affiliates. .\" Copyright (c) 1989, AT&T. All rights reserved. .TH drv_getparm 9F "11 Dec 2020" "Oracle Solaris 11.4" "Kernel Functions" .SH NAME drv_getparm \- retrieve kernel state information .SH SYNOPSIS .LP .nf #include <sys/ddi.h> \fBint\fR \fBdrv_getparm\fR(\fBunsigned int\fR \fIparm\fR, \fBvoid *\fR\fIvalue_p\fR); .fi .SH INTERFACE LEVEL .sp .LP Architecture independent level 1 (DDI/DKI). .SH PARAMETERS .sp .ne 2 .mk .na \fB\fIparm\fR\fR .ad .RS 11n .rt The kernel parameter to be obtained. Possible values are: .RE .sp .ne 2 .mk .na \fB\fBLBOLT\fR\fR .ad .RS 11n .rt Read the value of \fBlbolt\fR. \fBlbolt\fR is a \fBclock_t\fR that represents the number of clock ticks since system boot. No special treatment is applied when this value overflows the maximum value of the signed integral type \fBclock_t\fR. When this occurs, its value will be negative and its magnitude will be decreasing until it again passes zero. It can therefore not be relied upon to provide an indication of the amount of time that passes since the last system reboot, nor should it be used to mark an absolute time in the system. Only the difference between two measurements of \fBlbolt\fR is significant. It is used in this way inside the system kernel for timing purposes. .RE .sp .ne 2 .mk .na \fB\fBPPGRP\fR\fR .ad .RS 11n .rt Read the process group identification number. This number determines which processes should receive a \fBHANGUP\fR or \fBBREAK\fR signal when detected by a driver. .RE .sp .ne 2 .mk .na \fB\fBUPROCP\fR\fR .ad .RS 11n .rt Read the process table token value. .RE .sp .ne 2 .mk .na \fB\fBPPID\fR\fR .ad .RS 11n .rt Read process identification number. .RE .sp .ne 2 .mk .na \fB\fBPSID\fR\fR .ad .RS 11n .rt Read process session identification number. .RE .sp .ne 2 .mk .na \fB\fBTIME\fR\fR .ad .RS 11n .rt Read time in seconds. .RE .sp .ne 2 .mk .na \fB\fBUCRED\fR\fR .ad .RS 11n .rt Return a pointer to the caller's credential structure. .RE .sp .ne 2 .mk .na \fB\fIvalue_p\fR\fR .ad .RS 11n .rt A pointer to the data space in which the value of the parameter is to be copied. .RE .SH DESCRIPTION .sp .LP Since Solaris 2.6, the \fBdrv_getparm()\fR function has been replaced by \fBddi_get_lbolt\fR(9F), \fBddi_get_time\fR(9F), and \fBddi_get_pid\fR(9F). .sp .LP The \fBdrv_getparm()\fR function verifies that \fIparm\fR corresponds to a kernel parameter that may be read. If the value of \fIparm\fR does not correspond to a parameter or corresponds to a parameter that may not be read, \fB-1\fR is returned. Otherwise, the value of the parameter is stored in the data space pointed to by \fIvalue_p\fR. .sp .LP The \fBdrv_getparm()\fR function does not explicitly check to see whether the device has the appropriate context when the function is called and the function does not check for correct alignment in the data space pointed to by \fIvalue_p\fR. It is the responsibility of the driver writer to use this function only when it is appropriate to do so and to correctly declare the data space needed by the driver. .SH RETURN VALUES .sp .LP The \fBdrv_getparm()\fR function returns \fB0\fR to indicate success, \fB\(mi1\fR to indicate failure. The value stored in the space pointed to by \fIvalue_p\fR is the value of the parameter if \fB0\fR is returned, or undefined if \fB\(mi1\fR is returned. \fB\(mi1\fR is returned if you specify a value other than \fBLBOLT\fR, \fBPPGRP\fR, \fBPPID\fR, \fBPSID\fR, \fBTIME\fR, \fBUCRED\fR, or \fBUPROCP\fR. Always check the return code when using this function. .SH CONTEXT .sp .LP The \fBdrv_getparm()\fR function can be called from user context only when using \fBPPGRP\fR, \fBPPID\fR, \fBPSID\fR, \fBUCRED\fR, or \fBUPROCP\fR. It can be called from user, interrupt, or kernel context when using the \fBLBOLT\fR or \fBTIME\fR argument. .SH SEE ALSO .sp .LP \fBddi_get_lbolt\fR(9F), \fBddi_get_pid\fR(9F), \fBddi_get_time\fR(9F), \fBbuf\fR(9S) .sp .LP \fIWriting Device Drivers in Oracle Solaris 11.4\fR