00001 /* Berkelium - Embedded Chromium 00002 * Berkelium.hpp 00003 * 00004 * Copyright (c) 2009, Daniel Reiter Horn 00005 * All rights reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions are 00009 * met: 00010 * * Redistributions of source code must retain the above copyright 00011 * notice, this list of conditions and the following disclaimer. 00012 * * Redistributions in binary form must reproduce the above copyright 00013 * notice, this list of conditions and the following disclaimer in 00014 * the documentation and/or other materials provided with the 00015 * distribution. 00016 * * Neither the name of Sirikata nor the names of its contributors may 00017 * be used to endorse or promote products derived from this software 00018 * without specific prior written permission. 00019 * 00020 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS 00021 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 00022 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 00023 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER 00024 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 00025 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 00026 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 00027 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 00028 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 00029 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 00030 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00031 */ 00032 00033 #ifndef _BERKELIUM_HPP_ 00034 #define _BERKELIUM_HPP_ 00035 #include "berkelium/Platform.hpp" 00036 #include "berkelium/WeakString.hpp" 00037 00039 namespace sandbox { 00040 class BrokerServices; 00041 class TargetServices; 00042 #ifdef _WIN32 00043 enum DepEnforcement; 00044 #endif 00045 } 00048 namespace Berkelium { 00049 00052 class BERKELIUM_EXPORT ErrorDelegate { 00053 public: 00054 virtual ~ErrorDelegate() {} 00055 }; 00056 00057 /* TODO: Allow forkedProcessHook to be called without requiring the 00058 library to be initialized/in memory (unless this is a sub-process). 00059 i.e. an inline function that first searches for "--type=" in argv, 00060 then uses dlopen or GetProcAddress. 00061 */ 00062 00066 #ifdef _WIN32 00067 void BERKELIUM_EXPORT forkedProcessHook( 00068 sandbox::BrokerServices* (*ptrGetBrokerServices)(), 00069 sandbox::TargetServices* (*ptrGetTargetServices)(), 00070 bool (*ptrSetCurrentProcessDEP)(enum sandbox::DepEnforcement)); 00071 #else 00072 void BERKELIUM_EXPORT forkedProcessHook(int argc, char **argv); 00073 #endif 00074 00080 bool BERKELIUM_EXPORT init(FileString homeDirectory, FileString subprocessDirectory, unsigned int extra_argc = 0, const char* extra_argv[] = NULL); 00081 00086 bool BERKELIUM_EXPORT init(FileString homeDirectory, unsigned int extra_argc = 0, const char* extra_argv[] = NULL); 00087 00092 void BERKELIUM_EXPORT destroy(); 00093 00094 void BERKELIUM_EXPORT setErrorHandler(ErrorDelegate * errorHandler); 00095 00104 void BERKELIUM_EXPORT update(); 00105 void BERKELIUM_EXPORT runUntilStopped(); 00106 void BERKELIUM_EXPORT stopRunning(); 00107 00112 void BERKELIUM_EXPORT setCookie (URLString url, WideString cookieString); 00113 } 00114 00115 #endif