VBoxGuestR3LibLog.cpp revision e64031e20c39650a7bc902a3e1aba613b9415dee
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, Logging.
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsync * Copyright (C) 2007-2010 Oracle Corporation
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * available from http://www.virtualbox.org. This file is free software;
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * you can redistribute it and/or modify it under the terms of the GNU
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * General Public License (GPL) as published by the Free Software
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsync * The contents of this file may alternatively be used under the terms
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsync * of the Common Development and Distribution License Version 1.0
1c94c0a63ba68be1a7b2c640e70d7a06464e4fcavboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * VirtualBox OSE distribution, in which case the provisions of the
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * CDDL are applicable instead of those of the GPL.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * You may elect to license modified versions of this file under the
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * terms and conditions of either the GPL or the CDDL or both.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync/*******************************************************************************
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync* Header Files *
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync*******************************************************************************/
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * Write to the backdoor logger from ring 3 guest code.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * @returns IPRT status code.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * @param pch The string to log. Does not need to be terminated.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * @param cch The number of chars (bytes) to log.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * @remarks This currently does not accept more than 255 bytes of data at
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * one time. It should probably be rewritten to use pass a pointer
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * in the IOCtl.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsyncVBGLR3DECL(int) VbglR3WriteLog(const char *pch, size_t cch)
223cf005b18af2c21352a70693ebaf0582f68ebcvboxsync * Quietly skip NULL strings.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * (Happens in the RTLogBackdoorPrintf case.)
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * Duplicate the string as it may be read only (a C string).
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_LOG(cch), pvTmp, cch);
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync#elif 0 /** @todo Several OSes could take this route (solaris and freebsd for instance). */
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * Handle the entire request in one go.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync return vbglR3DoIOCtl(VBOXGUEST_IOCTL_LOG(cch), pvTmp, cch);
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * *BSD does not accept more than 4KB per ioctl request, while
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync * Linux can't express sizes above 8KB, so, split it up into 2KB chunks.
d408b82da0773c7e8cd4b3a01cb8a065a2c73a2dvboxsync for (size_t off = 0; off < cch && RT_SUCCESS(rc); off += STEP)