mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-20 14:16:02 +00:00
6f52b16c5b
Many user space API headers are missing licensing information, which makes it hard for compliance tools to determine the correct license. By default are files without license information under the default license of the kernel, which is GPLV2. Marking them GPLV2 would exclude them from being included in non GPLV2 code, which is obviously not intended. The user space API headers fall under the syscall exception which is in the kernels COPYING file: NOTE! This copyright does *not* cover user programs that use kernel services by normal system calls - this is merely considered normal use of the kernel, and does *not* fall under the heading of "derived work". otherwise syscall usage would not be possible. Update the files which contain no license information with an SPDX license identifier. The chosen identifier is 'GPL-2.0 WITH Linux-syscall-note' which is the officially assigned identifier for the Linux syscall exception. SPDX license identifiers are a legally binding shorthand, which can be used instead of the full boiler plate text. This patch is based on work done by Thomas Gleixner and Kate Stewart and Philippe Ombredanne. See the previous patch in this series for the methodology of how this patch was researched. Reviewed-by: Kate Stewart <kstewart@linuxfoundation.org> Reviewed-by: Philippe Ombredanne <pombredanne@nexb.com> Reviewed-by: Thomas Gleixner <tglx@linutronix.de> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
104 lines
3.4 KiB
C
104 lines
3.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
/*
|
|
*
|
|
* envctrl.h: Definitions for access to the i2c environment
|
|
* monitoring on Ultrasparc systems.
|
|
*
|
|
* Copyright (C) 1998 Eddie C. Dost (ecd@skynet.be)
|
|
* Copyright (C) 2000 Vinh Truong (vinh.truong@eng.sun.com)
|
|
* VT - Add all ioctl commands and environment status definitions
|
|
* VT - Add application note
|
|
*/
|
|
#ifndef _SPARC64_ENVCTRL_H
|
|
#define _SPARC64_ENVCTRL_H 1
|
|
|
|
#include <linux/ioctl.h>
|
|
|
|
/* Application note:
|
|
*
|
|
* The driver supports 4 operations: open(), close(), ioctl(), read()
|
|
* The device name is /dev/envctrl.
|
|
* Below is sample usage:
|
|
*
|
|
* fd = open("/dev/envtrl", O_RDONLY);
|
|
* if (ioctl(fd, ENVCTRL_READ_SHUTDOWN_TEMPERATURE, 0) < 0)
|
|
* printf("error\n");
|
|
* ret = read(fd, buf, 10);
|
|
* close(fd);
|
|
*
|
|
* Notice in the case of cpu voltage and temperature, the default is
|
|
* cpu0. If we need to know the info of cpu1, cpu2, cpu3, we need to
|
|
* pass in cpu number in ioctl() last parameter. For example, to
|
|
* get the voltage of cpu2:
|
|
*
|
|
* ioctlbuf[0] = 2;
|
|
* if (ioctl(fd, ENVCTRL_READ_CPU_VOLTAGE, ioctlbuf) < 0)
|
|
* printf("error\n");
|
|
* ret = read(fd, buf, 10);
|
|
*
|
|
* All the return values are in ascii. So check read return value
|
|
* and do appropriate conversions in your application.
|
|
*/
|
|
|
|
/* IOCTL commands */
|
|
|
|
/* Note: these commands reflect possible monitor features.
|
|
* Some boards choose to support some of the features only.
|
|
*/
|
|
#define ENVCTRL_RD_CPU_TEMPERATURE _IOR('p', 0x40, int)
|
|
#define ENVCTRL_RD_CPU_VOLTAGE _IOR('p', 0x41, int)
|
|
#define ENVCTRL_RD_FAN_STATUS _IOR('p', 0x42, int)
|
|
#define ENVCTRL_RD_WARNING_TEMPERATURE _IOR('p', 0x43, int)
|
|
#define ENVCTRL_RD_SHUTDOWN_TEMPERATURE _IOR('p', 0x44, int)
|
|
#define ENVCTRL_RD_VOLTAGE_STATUS _IOR('p', 0x45, int)
|
|
#define ENVCTRL_RD_SCSI_TEMPERATURE _IOR('p', 0x46, int)
|
|
#define ENVCTRL_RD_ETHERNET_TEMPERATURE _IOR('p', 0x47, int)
|
|
#define ENVCTRL_RD_MTHRBD_TEMPERATURE _IOR('p', 0x48, int)
|
|
|
|
#define ENVCTRL_RD_GLOBALADDRESS _IOR('p', 0x49, int)
|
|
|
|
/* Read return values for a voltage status request. */
|
|
#define ENVCTRL_VOLTAGE_POWERSUPPLY_GOOD 0x01
|
|
#define ENVCTRL_VOLTAGE_BAD 0x02
|
|
#define ENVCTRL_POWERSUPPLY_BAD 0x03
|
|
#define ENVCTRL_VOLTAGE_POWERSUPPLY_BAD 0x04
|
|
|
|
/* Read return values for a fan status request.
|
|
* A failure match means either the fan fails or
|
|
* the fan is not connected. Some boards have optional
|
|
* connectors to connect extra fans.
|
|
*
|
|
* There are maximum 8 monitor fans. Some are cpu fans
|
|
* some are system fans. The mask below only indicates
|
|
* fan by order number.
|
|
* Below is a sample application:
|
|
*
|
|
* if (ioctl(fd, ENVCTRL_READ_FAN_STATUS, 0) < 0) {
|
|
* printf("ioctl fan failed\n");
|
|
* }
|
|
* if (read(fd, rslt, 1) <= 0) {
|
|
* printf("error or fan not monitored\n");
|
|
* } else {
|
|
* if (rslt[0] == ENVCTRL_ALL_FANS_GOOD) {
|
|
* printf("all fans good\n");
|
|
* } else if (rslt[0] == ENVCTRL_ALL_FANS_BAD) {
|
|
* printf("all fans bad\n");
|
|
* } else {
|
|
* if (rslt[0] & ENVCTRL_FAN0_FAILURE_MASK) {
|
|
* printf("fan 0 failed or not connected\n");
|
|
* }
|
|
* ......
|
|
*/
|
|
|
|
#define ENVCTRL_ALL_FANS_GOOD 0x00
|
|
#define ENVCTRL_FAN0_FAILURE_MASK 0x01
|
|
#define ENVCTRL_FAN1_FAILURE_MASK 0x02
|
|
#define ENVCTRL_FAN2_FAILURE_MASK 0x04
|
|
#define ENVCTRL_FAN3_FAILURE_MASK 0x08
|
|
#define ENVCTRL_FAN4_FAILURE_MASK 0x10
|
|
#define ENVCTRL_FAN5_FAILURE_MASK 0x20
|
|
#define ENVCTRL_FAN6_FAILURE_MASK 0x40
|
|
#define ENVCTRL_FAN7_FAILURE_MASK 0x80
|
|
#define ENVCTRL_ALL_FANS_BAD 0xFF
|
|
|
|
#endif /* !(_SPARC64_ENVCTRL_H) */
|