1*7c478bd9Sstevel@tonic-gate /* 2*7c478bd9Sstevel@tonic-gate * CDDL HEADER START 3*7c478bd9Sstevel@tonic-gate * 4*7c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 5*7c478bd9Sstevel@tonic-gate * Common Development and Distribution License, Version 1.0 only 6*7c478bd9Sstevel@tonic-gate * (the "License"). You may not use this file except in compliance 7*7c478bd9Sstevel@tonic-gate * with the License. 8*7c478bd9Sstevel@tonic-gate * 9*7c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10*7c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 11*7c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 12*7c478bd9Sstevel@tonic-gate * and limitations under the License. 13*7c478bd9Sstevel@tonic-gate * 14*7c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 15*7c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16*7c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 17*7c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 18*7c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 19*7c478bd9Sstevel@tonic-gate * 20*7c478bd9Sstevel@tonic-gate * CDDL HEADER END 21*7c478bd9Sstevel@tonic-gate */ 22*7c478bd9Sstevel@tonic-gate /* 23*7c478bd9Sstevel@tonic-gate * Copyright 2003 Sun Microsystems, Inc. All rights reserved. 24*7c478bd9Sstevel@tonic-gate * Use is subject to license terms. 25*7c478bd9Sstevel@tonic-gate * 26*7c478bd9Sstevel@tonic-gate *ident "%Z%%M% %I% %E% SMI" 27*7c478bd9Sstevel@tonic-gate * 28*7c478bd9Sstevel@tonic-gate */ 29*7c478bd9Sstevel@tonic-gate 30*7c478bd9Sstevel@tonic-gate package com.sun.solaris.domain.pools; 31*7c478bd9Sstevel@tonic-gate 32*7c478bd9Sstevel@tonic-gate /** 33*7c478bd9Sstevel@tonic-gate * The <code>DRM</code> interface specifies the contract between 34*7c478bd9Sstevel@tonic-gate * poold and higher level partitioning agents. 35*7c478bd9Sstevel@tonic-gate * 36*7c478bd9Sstevel@tonic-gate * <code>Poold</code> is designed to operate indepedently or as a 37*7c478bd9Sstevel@tonic-gate * member of a hierarchy of co-operating resource managers. In order 38*7c478bd9Sstevel@tonic-gate * to promote interaction and minimise implementation dependencies, 39*7c478bd9Sstevel@tonic-gate * the use of a common protocol which may be implemented in multiple 40*7c478bd9Sstevel@tonic-gate * languages is advocated. The protocol is provisionally named the 41*7c478bd9Sstevel@tonic-gate * "Distributed Resource Management" (DRM) protocol. 42*7c478bd9Sstevel@tonic-gate * 43*7c478bd9Sstevel@tonic-gate * This interface specifies how an implementation of the protocol 44*7c478bd9Sstevel@tonic-gate * would be implemented in Java. 45*7c478bd9Sstevel@tonic-gate * 46*7c478bd9Sstevel@tonic-gate * @see LogDRM 47*7c478bd9Sstevel@tonic-gate */ 48*7c478bd9Sstevel@tonic-gate 49*7c478bd9Sstevel@tonic-gate interface DRM { 50*7c478bd9Sstevel@tonic-gate /** 51*7c478bd9Sstevel@tonic-gate * Connect to a higher level partitioning agent. 52*7c478bd9Sstevel@tonic-gate * 53*7c478bd9Sstevel@tonic-gate * @param version The version of the protocol. 54*7c478bd9Sstevel@tonic-gate * @param url The location of the agent. 55*7c478bd9Sstevel@tonic-gate * @throws Exception If the connect fails. 56*7c478bd9Sstevel@tonic-gate */ connect(int version, String url)57*7c478bd9Sstevel@tonic-gate public void connect(int version, String url) throws Exception; 58*7c478bd9Sstevel@tonic-gate 59*7c478bd9Sstevel@tonic-gate /** 60*7c478bd9Sstevel@tonic-gate * Disconnect from a higher level partitioning agent. 61*7c478bd9Sstevel@tonic-gate * 62*7c478bd9Sstevel@tonic-gate * @throws Exception If the client is not connected. 63*7c478bd9Sstevel@tonic-gate */ disconnect()64*7c478bd9Sstevel@tonic-gate public void disconnect() throws Exception; 65*7c478bd9Sstevel@tonic-gate 66*7c478bd9Sstevel@tonic-gate /** 67*7c478bd9Sstevel@tonic-gate * Request resources via a higher level partitioning agent. 68*7c478bd9Sstevel@tonic-gate * 69*7c478bd9Sstevel@tonic-gate * @throws Exception If the request fails. 70*7c478bd9Sstevel@tonic-gate */ request()71*7c478bd9Sstevel@tonic-gate public void request() throws Exception; 72*7c478bd9Sstevel@tonic-gate 73*7c478bd9Sstevel@tonic-gate /** 74*7c478bd9Sstevel@tonic-gate * Offer resources via a higher level partitioning agent. 75*7c478bd9Sstevel@tonic-gate * 76*7c478bd9Sstevel@tonic-gate * @throws Exception If the offer fails. 77*7c478bd9Sstevel@tonic-gate */ offer()78*7c478bd9Sstevel@tonic-gate public void offer() throws Exception; 79*7c478bd9Sstevel@tonic-gate 80*7c478bd9Sstevel@tonic-gate /** 81*7c478bd9Sstevel@tonic-gate * Cancel a previous offer or request. 82*7c478bd9Sstevel@tonic-gate * 83*7c478bd9Sstevel@tonic-gate * @throws Exception If the cancel fails. 84*7c478bd9Sstevel@tonic-gate */ cancel()85*7c478bd9Sstevel@tonic-gate public void cancel() throws Exception; 86*7c478bd9Sstevel@tonic-gate } 87