goldfish_pipe.h revision 89217f57a256796b67b4d3f319e0f18f6225666a
189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner/* Copyright (C) 2011 The Android Open Source Project 289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** 389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** This software is licensed under the terms of the GNU General Public 489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** License version 2, as published by the Free Software Foundation, and 589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** may be copied, distributed, and modified under those terms. 689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** 789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** This program is distributed in the hope that it will be useful, 889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** but WITHOUT ANY WARRANTY; without even the implied warranty of 989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 1089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner** GNU General Public License for more details. 1189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner*/ 1289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner#ifndef _HW_GOLDFISH_PIPE_H 1389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner#define _HW_GOLDFISH_PIPE_H 1489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner 1589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner#include <stdint.h> 1689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner#include "android/hw-qemud.h" 1789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner 1889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner/* The following functions should called from hw/goldfish_trace.c and are 1989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * used to implement QEMUD 'fast-pipes' in the Android emulator. 2089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner */ 2189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turnerextern void goldfish_pipe_thread_death(int tid); 2289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turnerextern void goldfish_pipe_write(int tid, int offset, uint32_t value); 2389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turnerextern uint32_t goldfish_pipe_read(int tid, int offset); 2489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner 2589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner/* The following definitions are used to define a "pipe handler" type. 2689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * Each pipe handler manages a given, named pipe type, and must provide 2789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * a few callbacks that will be used at appropriate times: 2889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 2989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * - init :: 3089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * is called when a guest client has connected to a given 3189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * pipe. The function should return an opaque pointer that 3289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * will be passed as the first parameter to other callbacks. 3389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 3489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * Note: pipeOpaque is the value that was passed to 3589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * goldfish_pipe_add_type() to register the pipe handler. 3689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 3789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * - close :: 3889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * is called when the pipe is closed.(either from the guest, or 3989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * when the handler itself calls qemud_client_close() on the 4089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * corresponding QemudClient object passed to init()). 4189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 4289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * - sendBuffers :: 4389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * is called when the guest is sending data through the pipe. This 4489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * callback receives a list of buffer descriptors that indicate 4589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * where the data is located in memory. 4689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 4789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * Must return 0 on success, or -1 on failure, with errno of: 4889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 4989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * ENOMEM -> indicates that the message is too large 5089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * EAGAIN -> indicates that the handler is not ready 5189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * to accept the message yet. 5289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 5389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * - recvBuffers :: 5489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * Is called when the guest wants to receive data from the pipe. 5589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * The caller provides a list of memory buffers to put the data into. 5689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 5789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * Must return the size of the incoming data on success, or -1 5889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * on error, with errno of: 5989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 6089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * ENOMEM -> buffer too small to receive the message 6189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * EAGAIN -> no incoming data yet 6289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * 6389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * - wakeOn :: 6489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * is called to indicate that the guest wants to be waked when the 6589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * pipe becomes able to either receive data from the guest, or send it 6689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * new incoming data. It is the responsability of the pipe handler to 6789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * signal the corresponding events by sending a single byte containing 6889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * QEMUD_PIPE_WAKE_XXX bit flags through qemud_client_send() to do so. 6989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner */ 7089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner 7189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turnerenum { 7289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner QEMUD_PIPE_WAKE_ON_SEND = (1 << 0), 7389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner QEMUD_PIPE_WAKE_ON_RECV = (1 << 1), 7489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner}; 7589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner 7689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner/* Buffer descriptor for sendBuffers() and recvBuffers() callbacks */ 7789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turnertypedef struct GoldfishPipeBuffer { 7889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner uint8_t* data; 7989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner size_t size; 8089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner} GoldfishPipeBuffer; 8189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner 8289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner/* Pipe handler funcs */ 8389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turnertypedef struct { 8489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner void* (*init)( QemudClient* client, void* pipeOpaque ); 8589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner void (*close)( void* opaque ); 8689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner int (*sendBuffers)( void* opaque, const GoldfishPipeBuffer* buffers, int numBuffers ); 8789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner int (*recvBuffers)( void* opaque, GoldfishPipeBuffer* buffers, int numBuffers ); 8889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner void (*wakeOn)( void* opaque, int flags ); 8989217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner} QemudPipeHandlerFuncs; 9089217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner 9189217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner/* Register a new pipe handler type. 'pipeOpaque' is passed directly 9289217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner * to 'init() when a new pipe is connected to. 9389217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner */ 9489217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turnerextern void goldfish_pipe_add_type(const char* pipeName, 9589217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner void* pipeOpaque, 9689217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner const QemudPipeHandlerFuncs* pipeFuncs ); 9789217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner 9889217f57a256796b67b4d3f319e0f18f6225666aDavid 'Digit' Turner#endif /* _HW_GOLDFISH_PIPE_H */ 99