15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.security.jgss;
  27 
  28 import org.ietf.jgss.*;
  29 
  30 /**
  31  * The extended GSSContext interface for supporting additional
  32  * functionalities not defined by {@code org.ietf.jgss.GSSContext},
  33  * such as querying context-specific attributes.
  34  */

  35 public interface ExtendedGSSContext extends GSSContext {
  36     /**
  37      * Return the mechanism-specific attribute associated with {@code type}.
  38      * <br><br>
  39      * For each supported attribute type, the type for the output are
  40      * defined below.
  41      * <ol>
  42      * <li>{@code KRB5_GET_TKT_FLAGS}:
  43      * the returned object is a boolean array for the service ticket flags,
  44      * which is long enough to contain all true bits. This means if
  45      * the user wants to get the <em>n</em>'th bit but the length of the
  46      * returned array is less than <em>n</em>, it is regarded as false.
  47      * <li>{@code KRB5_GET_SESSION_KEY}:
  48      * the returned object is an instance of {@link java.security.Key},
  49      * which has the following properties:
  50      *    <ul>
  51      *    <li>Algorithm: enctype as a string, where
  52      *        enctype is defined in RFC 3961, section 8.
  53      *    <li>Format: "RAW"
  54      *    <li>Encoded form: the raw key bytes, not in any ASN.1 encoding

  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.security.jgss;
  27 
  28 import org.ietf.jgss.*;
  29 
  30 /**
  31  * The extended GSSContext interface for supporting additional
  32  * functionalities not defined by {@code org.ietf.jgss.GSSContext},
  33  * such as querying context-specific attributes.
  34  */
  35 @jdk.Supported
  36 public interface ExtendedGSSContext extends GSSContext {
  37     /**
  38      * Return the mechanism-specific attribute associated with {@code type}.
  39      * <br><br>
  40      * For each supported attribute type, the type for the output are
  41      * defined below.
  42      * <ol>
  43      * <li>{@code KRB5_GET_TKT_FLAGS}:
  44      * the returned object is a boolean array for the service ticket flags,
  45      * which is long enough to contain all true bits. This means if
  46      * the user wants to get the <em>n</em>'th bit but the length of the
  47      * returned array is less than <em>n</em>, it is regarded as false.
  48      * <li>{@code KRB5_GET_SESSION_KEY}:
  49      * the returned object is an instance of {@link java.security.Key},
  50      * which has the following properties:
  51      *    <ul>
  52      *    <li>Algorithm: enctype as a string, where
  53      *        enctype is defined in RFC 3961, section 8.
  54      *    <li>Format: "RAW"
  55      *    <li>Encoded form: the raw key bytes, not in any ASN.1 encoding