1 /*
2 * Copyright 2000-2003 Sun Microsystems, Inc. All Rights Reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
20 * CA 95054 USA or visit www.sun.com if you need additional information or
21 * have any questions.
22 *
23 */
24
25 package sun.jvm.hotspot.debugger;
26
27 /** <P> This interface abstracts over access to operating system-level
28 threads in the underlying process. It is designed to be minimal
29 and generic to allow cross-platform compatibility. </P>
30
31 <P> The basic operation this interface supports is creating a
32 sun.jvm.hotspot.debugger.ThreadProxy "token" for an existing
33 thread. As an example, the HotSpot VM contains a list of Java
34 threads, encapsulated in VM-specific JavaThread objects. Each of
35 these contains a platform-dependent field with the OS-level thread
36 identifier; on Solaris, this field's type is "thread_t", while on
37 Windows, it is HANDLE. It is necessary to be able to map from
38 these fields to a ThreadProxy object, in particular to be able to
39 get the thread's context. However, since the types of these fields
40 vary greatly from OS to OS (some use integers as thread IDs, some
|
1 /*
2 * Copyright (c) 2000, 2003, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores,
20 * CA 94065 USA or visit www.oracle.com if you need additional information or
21 * have any questions.
22 *
23 */
24
25 package sun.jvm.hotspot.debugger;
26
27 /** <P> This interface abstracts over access to operating system-level
28 threads in the underlying process. It is designed to be minimal
29 and generic to allow cross-platform compatibility. </P>
30
31 <P> The basic operation this interface supports is creating a
32 sun.jvm.hotspot.debugger.ThreadProxy "token" for an existing
33 thread. As an example, the HotSpot VM contains a list of Java
34 threads, encapsulated in VM-specific JavaThread objects. Each of
35 these contains a platform-dependent field with the OS-level thread
36 identifier; on Solaris, this field's type is "thread_t", while on
37 Windows, it is HANDLE. It is necessary to be able to map from
38 these fields to a ThreadProxy object, in particular to be able to
39 get the thread's context. However, since the types of these fields
40 vary greatly from OS to OS (some use integers as thread IDs, some
|