Android开发工具—ADB(Android Debug Bridge) 3 - DalvikVM之jdwp线程

jdwp(java debug wire protocol)是dalvik VM的一个线程，可以建立在adb或者tcp基础上，与DDMS或debugger进行通信。

代码位置

dalvik/vm/jdwp

frameworks/base/core/jni

java虚拟机初始化后，或者每次“zygote fork”出一个新进程时，会启动jdwp线程。关于虚拟机的初始化参考我的博客http://blog.csdn.net/yinlijun2004/article/details/6065979。

主要调用路径:dvmStartup->dvmInitAfterZygote->dvmInitJDWP

dvmInitJDWP线程启动之前会可能会阻塞VM，依赖于配置suspend=n，所以dvmInitJDWP放在dvmStartup的最后步骤来执行。
dvmInitJDWP首先判断jdwp是否允许并且已经配置好，如果是，则读取jdwp的配置，这些配置是AndroidRuntime::startVm中配置的，

[cpp]  view plain copy

1.     /* enable debugging; set suspend=y to pause during VM init */  
2. #ifdef HAVE_ANDROID_OS  
3.     /* use android ADB transport */  
4.     opt.optionString =  
5.         "-agentlib:jdwp=transport=dt_android_adb,suspend=n,server=y";  
6. #else  
7.     /* use TCP socket; address=0 means start at port 8000 and probe up */  
8.     LOGI("Using TCP socket for JDWP\n");  
9.     opt.optionString =  
10.         "-agentlib:jdwp=transport=dt_socket,suspend=n,server=y,address=0";  
11. #endif  

这些配置保存在虚拟机全局变量gDvm中，gDvm是DvmGlobals变量，需要读取的配置包括transport，负责与ADB或TCP交换数据，

[cpp]  view plain copy

1. if (gDvm.jdwpAllowed && gDvm.jdwpConfigured) {  
2.     JdwpStartupParams params;  
3.   
4.   
5.     if (gDvm.jdwpHost != NULL) {  
6.         if (strlen(gDvm.jdwpHost) >= sizeof(params.host)-1) {  
7.             LOGE("ERROR: hostname too long: '%s'\n", gDvm.jdwpHost);  
8.             return false;  
9.         }  
10.         strcpy(params.host, gDvm.jdwpHost);  
11.     } else {  
12.         params.host[0] = '\0';  
13.     }  
14.     params.transport = gDvm.jdwpTransport;  
15.     params.server = gDvm.jdwpServer;  
16.     params.suspend = gDvm.jdwpSuspend;  
17.     params.port = gDvm.jdwpPort;  
18.   
19.   
20.     gDvm.jdwpState = dvmJdwpStartup(&params);  
21.     if (gDvm.jdwpState == NULL) {  
22.         LOGW("WARNING: debugger thread failed to initialize\n");  
23.         /* TODO: ignore? fail? need to mimic "expected" behavior */  
24.     }  
25. }  

其中gDvm.jdwpAllowed在dalvik_system_Zygote.c中配置
        gDvm.jdwpAllowed = ((debugFlags & DEBUG_ENABLE_DEBUGGER) != 0);
gDvm.jdwpConfigured在调用dvmStartup->dvmProcessOptions->parseJdwpOptions时配置。

参考上面的参数，对照Init.c的handleJdwpOption的函数，可知gDvm.jdwpTransport为kJdwpTransportAndroidAdb，gDvm.jdwpServer为true，gDvm.jdwpSuspend为false,gDvm.jdwpPort没有配置，这些参数保存到dvmJdwpStartup的参数里面。

再看dvmJdwpStartup，在里面，创建jdwp相关的结构体JdwpState，是先初始化一些互斥锁和条件锁，初始化transport

[cpp]  view plain copy

1. switch (pParams->transport) {  
2. case kJdwpTransportSocket:  
3.     // LOGD("prepping for JDWP over TCP\n");  
4.     state->transport = dvmJdwpSocketTransport();  
5.     break;  
6. case kJdwpTransportAndroidAdb:  
7.     // LOGD("prepping for JDWP over ADB\n");  
8.     state->transport = dvmJdwpAndroidAdbTransport();  
9.     /* TODO */  
10.     break;  
11. default:  
12.     LOGE("Unknown transport %d\n", pParams->transport);  
13.     assert(false);  
14.     goto fail;  
15. }  

由上文可知，这里执行dvmJdwpAndroidAdbTransport，返回一个JdwpTransport的接口指针结构体，这些在ADB和TCP上各有一套实现方法，对应不同类型的transport。

[cpp]  view plain copy

1. typedef struct JdwpTransport {  
2.     bool (*startup)(struct JdwpState* state, const JdwpStartupParams* pParams);  
3.     bool (*accept)(struct JdwpState* state);  
4.     bool (*establish)(struct JdwpState* state);  
5.     void (*close)(struct JdwpState* state);  
6.     void (*shutdown)(struct JdwpState* state);  
7.     void (*free)(struct JdwpState* state);  
8.     bool (*isConnected)(struct JdwpState* state);  
9.     bool (*awaitingHandshake)(struct JdwpState* state);  
10.     bool (*processIncoming)(struct JdwpState* state);  
11.     bool (*sendRequest)(struct JdwpState* state, ExpandBuf* pReq);  
12.     bool (*sendBufferedRequest)(struct JdwpState* state,  
13.         const struct iovec* iov, int iovcnt);  
14. } JdwpTransport;  

然后，调用dvmJdwpNetStartup，在里面实际执行JdwpTransport在ADB上的startup接口。在JdwpADB.c的start函数内，初始化与adb有关的一些网络参数，比如socket名称

[cpp]  view plain copy

1. #define kJdwpControlName    "\0jdwp-control"    

这个socket名称已经被adbd绑定。
然后，调用dvmCreateInternalThread启动jdwp线程，dvmCreateInternalThread是pthread_create的包装，最终线程的执行函数是jdwpThreadStart，
在jdwpThreadStart中，会调用dvmJdwpEstablishConnection与adbd建立连接。在dvmJdwpEstablishConnection中，会一直等待与adbd的连接，直到连接成功

[cpp]  view plain copy

1. int  ret = connect(netState->controlSock,                           
2.                    &netState->controlAddr.controlAddrPlain,         
3.                    netState->controlAddrLen);             

如果执行connect成功，则将pid发送给adbd，

[cpp]  view plain copy

1. snprintf(buff, sizeof(buff), "%04x", getpid());  
2. buff[4] = 0;  
3.         do {                                                            
4.             ret = send( netState->controlSock, buff, 4, 0 );            
5.         } while (ret < 0 && errno == EINTR);       

接着，jdwp等待adbd返回一个客户文件描述符，

[cpp]  view plain copy

1. netState->clientSock = receiveClientFd(netState);  

如果返回成功，这个clientSock将用来直接与debugger或DDMS通信。可以想象，这里的clientSock就是TCP:5037对应的client描述符。
这样acceptConnection也成功返回了，回到jdwp线程处理函数jdwpThreadStart，接着进入一个while循环从adbd读取并处理握手消息。

[cpp]  view plain copy

1. while (true) {  
2.     // sanity check -- shouldn't happen?  
3.     if (dvmThreadSelf()->status != THREAD_VMWAIT) {  
4.         LOGE("JDWP thread no longer in VMWAIT (now %d); resetting\n",  
5.             dvmThreadSelf()->status);  
6.         dvmDbgThreadWaiting();  
7.     }  
8.   
9.   
10.     if (!dvmJdwpProcessIncoming(state))     /* blocking read */  
11.         break;  
12.   
13.   
14.     if (first && !dvmJdwpAwaitingHandshake(state)) {  
15.         /* handshake worked, tell the interpreter that we're active */  
16.         first = false;  
17.   
18.   
19.         /* set thread ID; requires object registry to be active */  
20.         state->debugThreadId = dvmDbgGetThreadSelfId();  
21.   
22.   
23.         /* wake anybody who's waiting for us */  
24.         dvmDbgLockMutex(&state->attachLock);  
25.         dvmDbgCondBroadcast(&state->attachCond);  
26.         dvmDbgUnlockMutex(&state->attachLock);  
27.     }  
28. }  

先看dvmJdwpProcessIncoming函数，在里面执行select，可能会收到三种数据，对应三个文件描述被set，其中wakeFds是定时唤醒作用，丢弃，controlSock的set也忽略，因为不需要接收第二个debugger文件描述服。之后收到debugger的数据，也就是clientSock被set的时候调用read读取数据，如果不一个单位数据包长度，则dvmJdwpProcessIncoming返回。否则，调用handlePacket处理数据包，
handlePacket->dvmJdwpProcessRequest->write
handlePacket从讲包中的数据还原成JdwpReqHeader和数据起始指针，送给dvmJdwpProcessRequest处理，dvmJdwpProcessRequest从gHandlerMap调出处理函数func

[cpp]  view plain copy

1. typedef struct {                                                                
2.     u1  cmdSet;                                                                 
3.     u1  cmd;  
4.     JdwpRequestHandler  func;                                                   
5.     const char* descr;                                                          
6. } JdwpHandlerMap;    

write讲结果，写回给adbd，adbd处理之后在发回给HOST端。