xref: /onnv-gate/usr/src/uts/sun4v/sys/vcc.h (revision 2748:85615553b3bb)

/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License (the "License").
 * You may not use this file except in compliance with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */

/*
 * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

#ifndef _VCC_H
#define	_VCC_H

#pragma ident	"%Z%%M%	%I%	%E% SMI"

#ifdef __cplusplus
extern "C" {
#endif

#include <sys/stream.h>
#include <sys/ddi.h>
#include <sys/sunddi.h>
#include <sys/ioctl.h>

/*
 * vcc and vntsd exchange information using ioctl commands. When vntsd starts,
 * it uses VCC_NUM_CONSOLE to get number of existing ports and
 * VCC_CONS_TBL to obtain the table of existing consoles. In this table,
 * vcc returns information about each of the console ports using vcc_console_t
 * structure. Vntsd then sleeps on polling vcc control port.
 *
 * When there is a change in configuration, such as addtion or deletion
 * of a console port, vcc wakes up vntsd via the poll events. Subsequently,
 * vntsd uses VCC_INQUIRY ioctl to determine the reason for wakeup. In
 * response to the inquiry, vcc provides a vcc_response_t structure
 * containing reason and port number.
 *
 * If a port is being added or updated (group change), vntsd uses
 * VCC_CONS_INFO ioctl with port number to obtain configuration of
 * the port.
 *
 * If the port is being deleted, vntsd uses VCC_DEL_CONS_OK ioctl to notify
 * vcc after its clean up is done. Vcc subsequently tears down
 * its internal configuration and remove the associated TTY minor node.
 *
 * Only one open is allowd for each vcc port. If vntsd opens a port that is
 * already open, vntsd will use VNTSD_FORCE_CLOSE to take port from other
 * application
 */

/* VCC CNTRL IOCTL */

#define	    VCC_IOCTL_CMD		('c' << 8)


#define	    VCC_NUM_CONSOLE	VCC_IOCTL_CMD | 0x1	/* num of consoles */
#define	    VCC_CONS_TBL	VCC_IOCTL_CMD | 0x2	/* config table */
#define	    VCC_INQUIRY		VCC_IOCTL_CMD | 0x3	/* inquiry by vntsd */
#define	    VCC_CONS_INFO	VCC_IOCTL_CMD | 0x4	/* config */
#define	    VCC_CONS_STATUS	VCC_IOCTL_CMD | 0x5	/* console status */
#define	    VCC_FORCE_CLOSE	VCC_IOCTL_CMD | 0x6	/* force to close */

/* reasons to wake up vntsd */
typedef enum {
	VCC_CONS_ADDED,		    /* a port was added */
	VCC_CONS_DELETED,	    /* a port was removed */
	VCC_CONS_MISS_ADDED,	    /* wakeup after an added port was deleted */
	/* XXX not implemented yet */
	VCC_CONS_UPDATED	    /* a port configuration was changed */
} vcc_reason_t;

/*
 * structure that vcc returns to vntsd in response to VCC_CONS_TBL and
 * VCC_CONS_INFO  ioctl call.
 */
typedef struct vcc_console {
	int		cons_no;		    /* console port number  */
	uint64_t	tcp_port;		    /* tcp port for the group */
	char		domain_name[MAXPATHLEN];    /* domain name */
	char		group_name[MAXPATHLEN];	    /* group name */
	char		dev_name[MAXPATHLEN];
} vcc_console_t;

/* structure that vcc sends to vntsd in response to wake up inquiry */
typedef struct vcc_response {
	int		cons_no;	/* console port number */
	vcc_reason_t	reason;		/* wake up reason */
} vcc_response_t;

#ifdef __cplusplus
}
#endif

#endif /* _VCC_H */