/* $Id: vbsf.cpp 51250 2014-05-14 08:11:22Z vboxsync $ */ /** @file * Shared Folders - VBox Shared Folders. */ /* * Copyright (C) 2006-2013 Oracle Corporation * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License (GPL) as published by the Free Software * Foundation, in version 2 as it comes in the "COPYING" file of the * VirtualBox OSE distribution. VirtualBox OSE is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. */ #ifdef UNITTEST # include "testcase/tstSharedFolderService.h" #endif #include "mappings.h" #include "vbsf.h" #include "shflhandle.h" #include #include #include #include #include #include #include #include #include #include #ifdef RT_OS_DARWIN # include #endif #ifdef UNITTEST # include "teststubs.h" #endif #define SHFL_RT_LINK(pClient) ((pClient)->fu32Flags & SHFL_CF_SYMLINKS ? RTPATH_F_ON_LINK : RTPATH_F_FOLLOW_LINK) /** * @todo find a better solution for supporting the execute bit for non-windows * guests on windows host. Search for "0111" to find all the relevant places. */ void vbsfStripLastComponent(char *pszFullPath, uint32_t cbFullPathRoot) { RTUNICP cp; /* Do not strip root. */ char *s = pszFullPath + cbFullPathRoot; char *delimSecondLast = NULL; char *delimLast = NULL; LogFlowFunc(("%s -> %s\n", pszFullPath, s)); for (;;) { cp = RTStrGetCp(s); if (cp == RTUNICP_INVALID || cp == 0) { break; } if (cp == RTPATH_DELIMITER) { if (delimLast != NULL) { delimSecondLast = delimLast; } delimLast = s; } s = RTStrNextCp(s); } if (cp == 0) { if (delimLast + 1 == s) { if (delimSecondLast) { *delimSecondLast = 0; } else if (delimLast) { *delimLast = 0; } } else { if (delimLast) { *delimLast = 0; } } } LogFlowFunc(("%s, %s, %s\n", pszFullPath, delimLast, delimSecondLast)); } /** * Corrects the casing of the final component * * @returns * @param pClient . * @param pszFullPath . * @param pszStartComponent . */ static int vbsfCorrectCasing(SHFLCLIENTDATA *pClient, char *pszFullPath, char *pszStartComponent) { Log2(("vbsfCorrectCasing: %s %s\n", pszFullPath, pszStartComponent)); AssertReturn((uintptr_t)pszFullPath < (uintptr_t)pszStartComponent - 1U, VERR_INTERNAL_ERROR_2); AssertReturn(pszStartComponent[-1] == RTPATH_DELIMITER, VERR_INTERNAL_ERROR_5); /* * Allocate a buffer that can hold really long file name entries as well as * the initial search pattern. */ size_t cchComponent = strlen(pszStartComponent); size_t cchParentDir = pszStartComponent - pszFullPath; size_t cchFullPath = cchParentDir + cchComponent; Assert(strlen(pszFullPath) == cchFullPath); size_t cbDirEntry = 4096; if (cchFullPath + 4 > cbDirEntry - RT_OFFSETOF(RTDIRENTRYEX, szName)) cbDirEntry = RT_OFFSETOF(RTDIRENTRYEX, szName) + cchFullPath + 4; PRTDIRENTRYEX pDirEntry = (PRTDIRENTRYEX)RTMemAlloc(cbDirEntry); if (pDirEntry == NULL) return VERR_NO_MEMORY; /* * Construct the search criteria in the szName member of pDirEntry. */ /** @todo This is quite inefficient, especially for directories with many * files. If any of the typically case sensitive host systems start * supporting opendir wildcard filters, it would make sense to build * one here with '?' for case foldable charaters. */ /** @todo Use RTDirOpen here and drop the whole uncessary path copying? */ int rc = RTPathJoinEx(pDirEntry->szName, cbDirEntry - RT_OFFSETOF(RTDIRENTRYEX, szName), pszFullPath, cchParentDir, RT_STR_TUPLE("*")); AssertRC(rc); if (RT_SUCCESS(rc)) { PRTDIR hSearch = NULL; rc = RTDirOpenFiltered(&hSearch, pDirEntry->szName, RTDIRFILTER_WINNT, 0); if (RT_SUCCESS(rc)) { for (;;) { size_t cbDirEntrySize = cbDirEntry; rc = RTDirReadEx(hSearch, pDirEntry, &cbDirEntrySize, RTFSOBJATTRADD_NOTHING, SHFL_RT_LINK(pClient)); if (rc == VERR_NO_MORE_FILES) break; if ( rc != VINF_SUCCESS && rc != VWRN_NO_DIRENT_INFO) { AssertFailed(); if ( rc == VERR_NO_TRANSLATION || rc == VERR_INVALID_UTF8_ENCODING) continue; break; } Log2(("vbsfCorrectCasing: found %s\n", &pDirEntry->szName[0])); if ( pDirEntry->cbName == cchComponent && !RTStrICmp(pszStartComponent, &pDirEntry->szName[0])) { Log(("Found original name %s (%s)\n", &pDirEntry->szName[0], pszStartComponent)); strcpy(pszStartComponent, &pDirEntry->szName[0]); rc = VINF_SUCCESS; break; } } RTDirClose(hSearch); } } if (RT_FAILURE(rc)) Log(("vbsfCorrectCasing %s failed with %Rrc\n", pszStartComponent, rc)); RTMemFree(pDirEntry); return rc; } /* Temporary stand-in for RTPathExistEx. */ static int vbsfQueryExistsEx(const char *pszPath, uint32_t fFlags) { #if 0 /** @todo Fix the symlink issue on windows! */ return RTPathExistsEx(pszPath, fFlags); #else RTFSOBJINFO IgnInfo; return RTPathQueryInfoEx(pszPath, &IgnInfo, RTFSOBJATTRADD_NOTHING, fFlags); #endif } /** * Helper for vbsfBuildFullPath that performs case corrections on the path * that's being build. * * @returns VINF_SUCCESS at the moment. * @param pClient The client data. * @param pszFullPath Pointer to the full path. This is the path * which may need case corrections. The * corrections will be applied in place. * @param cchFullPath The length of the full path. * @param fWildCard Whether the last component may contain * wildcards and thus might require exclusion * from the case correction. * @param fPreserveLastComponent Always exclude the last component from case * correction if set. */ static int vbsfCorrectPathCasing(SHFLCLIENTDATA *pClient, char *pszFullPath, size_t cchFullPath, bool fWildCard, bool fPreserveLastComponent) { /* * Hide the last path component if it needs preserving. This is required * in the following cases: * - Contains the wildcard(s). * - Is a 'rename' target. */ char *pszLastComponent = NULL; if (fWildCard || fPreserveLastComponent) { char *pszSrc = pszFullPath + cchFullPath - 1; Assert(strchr(pszFullPath, '\0') == pszSrc + 1); while ((uintptr_t)pszSrc > (uintptr_t)pszFullPath) { if (*pszSrc == RTPATH_DELIMITER) break; pszSrc--; } if (*pszSrc == RTPATH_DELIMITER) { if ( fPreserveLastComponent /* Or does it really have wildcards? */ || strchr(pszSrc + 1, '*') != NULL || strchr(pszSrc + 1, '?') != NULL || strchr(pszSrc + 1, '>') != NULL || strchr(pszSrc + 1, '<') != NULL || strchr(pszSrc + 1, '"') != NULL ) { pszLastComponent = pszSrc; *pszLastComponent = '\0'; } } } /* * If the path/file doesn't exist, we need to attempt case correcting it. */ /** @todo Don't check when creating files or directories; waste of time. */ int rc = vbsfQueryExistsEx(pszFullPath, SHFL_RT_LINK(pClient)); if (rc == VERR_FILE_NOT_FOUND || rc == VERR_PATH_NOT_FOUND) { Log(("Handle case insensitive guest fs on top of host case sensitive fs for %s\n", pszFullPath)); /* * Work from the end of the path to find a partial path that's valid. */ char *pszSrc = pszLastComponent ? pszLastComponent - 1 : pszFullPath + cchFullPath - 1; Assert(strchr(pszFullPath, '\0') == pszSrc + 1); while ((uintptr_t)pszSrc > (uintptr_t)pszFullPath) { if (*pszSrc == RTPATH_DELIMITER) { *pszSrc = '\0'; rc = vbsfQueryExistsEx(pszFullPath, SHFL_RT_LINK(pClient)); *pszSrc = RTPATH_DELIMITER; if (RT_SUCCESS(rc)) { #ifdef DEBUG *pszSrc = '\0'; Log(("Found valid partial path %s\n", pszFullPath)); *pszSrc = RTPATH_DELIMITER; #endif break; } } pszSrc--; } Assert(*pszSrc == RTPATH_DELIMITER && RT_SUCCESS(rc)); if ( *pszSrc == RTPATH_DELIMITER && RT_SUCCESS(rc)) { /* * Turn around and work the other way case correcting the components. */ pszSrc++; for (;;) { bool fEndOfString = true; /* Find the end of the component. */ char *pszEnd = pszSrc; while (*pszEnd) { if (*pszEnd == RTPATH_DELIMITER) break; pszEnd++; } if (*pszEnd == RTPATH_DELIMITER) { fEndOfString = false; *pszEnd = '\0'; #if 0 /** @todo Please, double check this. The original code is in the #if 0, what I hold as correct is in the #else. */ rc = RTPathQueryInfoEx(pszSrc, &info, RTFSOBJATTRADD_NOTHING, SHFL_RT_LINK(pClient)); #else rc = vbsfQueryExistsEx(pszFullPath, SHFL_RT_LINK(pClient)); #endif Assert(rc == VINF_SUCCESS || rc == VERR_FILE_NOT_FOUND || rc == VERR_PATH_NOT_FOUND); } else if (pszEnd == pszSrc) rc = VINF_SUCCESS; /* trailing delimiter */ else rc = VERR_FILE_NOT_FOUND; if (rc == VERR_FILE_NOT_FOUND || rc == VERR_PATH_NOT_FOUND) { /* Path component is invalid; try to correct the casing. */ rc = vbsfCorrectCasing(pClient, pszFullPath, pszSrc); if (RT_FAILURE(rc)) { /* Failed, so don't bother trying any further components. */ if (!fEndOfString) *pszEnd = RTPATH_DELIMITER; /* Restore the original full path. */ break; } } /* Next (if any). */ if (fEndOfString) break; *pszEnd = RTPATH_DELIMITER; pszSrc = pszEnd + 1; } if (RT_FAILURE(rc)) Log(("Unable to find suitable component rc=%d\n", rc)); } else rc = VERR_FILE_NOT_FOUND; } /* Restore the final component if it was dropped. */ if (pszLastComponent) *pszLastComponent = RTPATH_DELIMITER; /* might be a new file so don't fail here! */ return VINF_SUCCESS; } /** @def VBSF_IS_PATH_SLASH * Checks if @a a_ch is a path delimiter (slash, not volume spearator) for the * guest or the host. * @param a_pClient Pointer to the client data (SHFLCLIENTDATA). * @param a_ch The character to inspect. */ #if 1 # define VBSF_IS_PATH_SLASH(a_pClient, a_ch) ( (a_ch) == '\\' || (a_ch) == '/' || RTPATH_IS_SLASH(a_ch) ) #else # define VBSF_IS_PATH_SLASH(a_pClient, a_ch) ( (RTUTF16)(a_ch) == (a_pClient)->PathDelimiter || RTPATH_IS_SLASH(a_ch) ) #endif /** * Check the given UTF-8 path for root escapes. * * Verify that the path is within the root directory of the mapping. Count '..' * and other path components and check that we do not go over the root. * * @returns VBox status code. * @retval VINF_SUCCESS * @retval VERR_INVALID_NAME * * @param pszPath The (UTF-8) path to check. Slashes has been convert * to host slashes by this time. * * @remarks This function assumes that the path will be appended to the root * directory of the shared folder mapping. Keep that in mind when * checking absolute paths! */ static int vbsfPathCheck(const char *pszPath) { /* * Walk the path, component by component and check for escapes. */ int cComponents = 0; /* How many normal path components. */ int cParentDirs = 0; /* How many '..' components. */ for (;;) { char ch; /* Skip leading path delimiters. */ do ch = *pszPath++; while (RTPATH_IS_SLASH(ch)); if (ch == '\0') return VINF_SUCCESS; /* Check if that is a dot component. */ int cDots = 0; while (ch == '.') { cDots++; ch = *pszPath++; } if ( cDots >= 1 && (ch == '\0' || RTPATH_IS_SLASH(ch)) ) { if (cDots >= 2) /* Consider all multidots sequences as a 'parent dir'. */ { cParentDirs++; /* Escaping? */ if (cParentDirs > cComponents) return VERR_INVALID_NAME; } /* else: Single dot, nothing changes. */ } else { /* Not a dot component, skip to the end of it. */ while (ch != '\0' && !RTPATH_IS_SLASH(ch)) ch = *pszPath++; cComponents++; } Assert(cComponents >= cParentDirs); /* The end? */ Assert(ch == '\0' || RTPATH_IS_SLASH(ch)); if (ch == '\0') return VINF_SUCCESS; } } static int vbsfBuildFullPath(SHFLCLIENTDATA *pClient, SHFLROOT root, PSHFLSTRING pPath, uint32_t cbPath, char **ppszFullPath, uint32_t *pcbFullPathRoot, bool fWildCard = false, bool fPreserveLastComponent = false) { /* Resolve the root prefix into a string. */ const char *pszRoot = vbsfMappingsQueryHostRoot(root); if ( !pszRoot || !*pszRoot) { Log(("vbsfBuildFullPath: invalid root!\n")); return VERR_INVALID_PARAMETER; } uint32_t cchRoot = (uint32_t)strlen(pszRoot); #if RTPATH_STYLE == RTPATH_STR_F_STYLE_DOS Assert(!strchr(pszRoot, '/')); #endif /* * Combine the root prefix with the guest path into a full UTF-8 path in a * buffer pointed to by pszFullPath. cchRoot may be adjusted in the process. */ int rc; size_t cchFullPath; char *pszFullPath = NULL; if (BIT_FLAG(pClient->fu32Flags, SHFL_CF_UTF8)) { /* Strip leading slashes from the path the guest specified. */ uint32_t cchSrc = pPath->u16Length; const char *pszSrc = (char *)&pPath->String.utf8[0]; Log(("Root %s path %.*s\n", pszRoot, cchSrc, pszSrc)); while ( cchSrc > 0 && VBSF_IS_PATH_SLASH(pClient, *pszSrc)) { pszSrc++; cchSrc--; } /* Allocate a buffer that will be able to contain the root prefix and the path specified by the guest. */ cchFullPath = cchRoot + cchSrc; pszFullPath = (char *)RTMemAlloc(cchFullPath + 1 + 1); if (RT_LIKELY(pszFullPath != NULL)) { memcpy(pszFullPath, pszRoot, cchRoot); if (!RTPATH_IS_SLASH(pszRoot[-1])) { pszFullPath[cchRoot++] = RTPATH_DELIMITER; cchFullPath++; } if (cchSrc) memcpy(&pszFullPath[cchRoot], pszSrc, cchSrc); /* Terminate the string. */ pszFullPath[cchRoot + cchSrc] = '\0'; rc = VINF_SUCCESS; } else { Log(("RTMemAlloc %x failed!!\n", cchFullPath + 1)); rc = VERR_NO_MEMORY; } } else /* Client speaks UTF-16. */ { #ifdef RT_OS_DARWIN /* Misplaced hack! See todo! */ /** @todo This belongs in rtPathToNative or in the windows shared folder file system driver... * The question is simply whether the NFD normalization is actually applied on a (virtual) file * system level in darwin, or just by the user mode application libs. */ SHFLSTRING *pPathParameter = pPath; size_t cbPathLength; CFMutableStringRef inStr = ::CFStringCreateMutable(NULL, 0); uint16_t ucs2Length; CFRange rangeCharacters; // Is 8 times length enough for decomposed in worst case...? cbPathLength = sizeof(SHFLSTRING) + pPathParameter->u16Length * 8 + 2; pPath = (SHFLSTRING *)RTMemAllocZ(cbPathLength); if (!pPath) { rc = VERR_NO_MEMORY; Log(("RTMemAllocZ %x failed!!\n", cbPathLength)); return rc; } ::CFStringAppendCharacters(inStr, (UniChar*)pPathParameter->String.ucs2, pPathParameter->u16Length / sizeof(pPathParameter->String.ucs2[0])); ::CFStringNormalize(inStr, kCFStringNormalizationFormD); ucs2Length = ::CFStringGetLength(inStr); rangeCharacters.location = 0; rangeCharacters.length = ucs2Length; ::CFStringGetCharacters(inStr, rangeCharacters, pPath->String.ucs2); pPath->String.ucs2[ucs2Length] = 0x0000; // NULL terminated pPath->u16Length = ucs2Length * sizeof(pPath->String.ucs2[0]); pPath->u16Size = pPath->u16Length + sizeof(pPath->String.ucs2[0]); CFRelease(inStr); #endif /* Strip leading slashes and calculate the UTF-8 length. */ size_t cwcSrc = pPath->u16Length / sizeof(RTUTF16); PRTUTF16 pwszSrc = &pPath->String.ucs2[0]; Log(("Root %s path %.*ls\n", pszRoot, cwcSrc, pwszSrc)); while ( cwcSrc > 0 && *pwszSrc < 0x80 && VBSF_IS_PATH_SLASH(pClient, (char)*pwszSrc)) { pwszSrc++; cwcSrc--; } size_t cchPathAsUtf8 = RTUtf16CalcUtf8Len(pwszSrc); #ifdef RT_OS_DARWIN AssertReturnStmt(cchPathAsUtf8 >= cwcSrc, RTMemFree(pPath), VERR_INTERNAL_ERROR_3); #else AssertReturn(cchPathAsUtf8 >= cwcSrc, VERR_INTERNAL_ERROR_3); #endif /* Allocate buffer that will be able to contain the root prefix and * the pPath converted to UTF-8. */ cchFullPath = cchRoot + cchPathAsUtf8; pszFullPath = (char *)RTMemAlloc(cchFullPath + 1 + 1); if (RT_LIKELY(pszFullPath != NULL)) { /* Copy the root prefix into the result buffer and make sure it ends with a path separator. */ memcpy(pszFullPath, pszRoot, cchRoot); if (!RTPATH_IS_SLASH(pszFullPath[cchRoot - 1])) { pszFullPath[cchRoot++] = RTPATH_DELIMITER; cchFullPath++; } /* Append the path specified by the guest (if any). */ if (cchPathAsUtf8) { size_t cchActual; char *pszDst = &pszFullPath[cchRoot]; rc = RTUtf16ToUtf8Ex(pwszSrc, cwcSrc, &pszDst, cchFullPath - cchRoot + 1, &cchActual); AssertRC(rc); AssertStmt(RT_FAILURE(rc) || cchActual == cchPathAsUtf8, rc = VERR_INTERNAL_ERROR_4); Assert(strlen(pszDst) == cchPathAsUtf8); } else rc = VINF_SUCCESS; /* Terminate the string. */ pszFullPath[cchRoot + cchPathAsUtf8] = '\0'; } else { Log(("RTMemAlloc %x failed!!\n", cchFullPath + 1)); rc = VERR_NO_MEMORY; } #ifdef RT_OS_DARWIN RTMemFree(pPath); pPath = pPathParameter; #endif } if (RT_SUCCESS(rc)) { Assert(strlen(pszFullPath) == cchFullPath); Assert(RTPATH_IS_SLASH(pszFullPath[cchRoot - 1])); /* includes delimiter. */ if (pcbFullPathRoot) *pcbFullPathRoot = cchRoot - 1; /* Must index the path delimiter. */ /* * Convert guest path delimiters into host ones and check for attempts * to escape the shared folder root directory. * * After this, there will only be RTPATH_DELIMITER slashes in the path! * * ASSUMES that the root path only has RTPATH_DELIMITER as well. */ char ch; char *pszTmp = &pszFullPath[cchRoot]; while ((ch = *pszTmp) != '\0') { if (VBSF_IS_PATH_SLASH(pClient, ch)) *pszTmp = RTPATH_DELIMITER; pszTmp++; } LogFlow(("Corrected string %s\n", pszFullPath)); rc = vbsfPathCheck(&pszFullPath[cchRoot]); if (RT_SUCCESS(rc)) { /* * When the host file system is case sensitive and the guest expects * a case insensitive fs, then problems can occur. */ if ( vbsfIsHostMappingCaseSensitive(root) && !vbsfIsGuestMappingCaseSensitive(root)) rc = vbsfCorrectPathCasing(pClient, pszFullPath, cchFullPath, fWildCard, fPreserveLastComponent); if (RT_SUCCESS(rc)) { /* * We're good. */ *ppszFullPath = pszFullPath; LogFlow(("vbsfBuildFullPath: %s rc=%Rrc\n", pszFullPath, rc)); return rc; } /* Failed, clean up. */ Log(("vbsfBuildFullPath: %s rc=%Rrc\n", pszFullPath, rc)); } else Log(("vbsfBuildPath: Caught escape attempt: (%.*s) '%s'\n", cchRoot, pszFullPath, &pszFullPath[cchRoot])); } if (pszFullPath) RTMemFree(pszFullPath); *ppszFullPath = NULL; return rc; } static void vbsfFreeFullPath(char *pszFullPath) { RTMemFree(pszFullPath); } /** * Convert shared folder create flags (see include/iprt/shflsvc.h) into iprt create flags. * * @returns iprt status code * @param fShflFlags shared folder create flags * @param fMode file attributes * @retval pfOpen iprt create flags */ static int vbsfConvertFileOpenFlags(unsigned fShflFlags, RTFMODE fMode, SHFLHANDLE handleInitial, uint32_t *pfOpen) { uint32_t fOpen = 0; int rc = VINF_SUCCESS; if ( (fMode & RTFS_DOS_MASK) != 0 && (fMode & RTFS_UNIX_MASK) == 0) { /* A DOS/Windows guest, make RTFS_UNIX_* from RTFS_DOS_*. * @todo this is based on rtFsModeNormalize/rtFsModeFromDos. * May be better to use RTFsModeNormalize here. */ fMode |= RTFS_UNIX_IRUSR | RTFS_UNIX_IRGRP | RTFS_UNIX_IROTH; /* x for directories. */ if (fMode & RTFS_DOS_DIRECTORY) fMode |= RTFS_TYPE_DIRECTORY | RTFS_UNIX_IXUSR | RTFS_UNIX_IXGRP | RTFS_UNIX_IXOTH; /* writable? */ if (!(fMode & RTFS_DOS_READONLY)) fMode |= RTFS_UNIX_IWUSR | RTFS_UNIX_IWGRP | RTFS_UNIX_IWOTH; /* Set the requested mode using only allowed bits. */ fOpen |= ((fMode & RTFS_UNIX_MASK) << RTFILE_O_CREATE_MODE_SHIFT) & RTFILE_O_CREATE_MODE_MASK; } else { /* Old linux and solaris additions did not initialize the Info.Attr.fMode field * and it contained random bits from stack. Detect this using the handle field value * passed from the guest: old additions set it (incorrectly) to 0, new additions * set it to SHFL_HANDLE_NIL(~0). */ if (handleInitial == 0) { /* Old additions. Do nothing, use default mode. */ } else { /* New additions or Windows additions. Set the requested mode using only allowed bits. * Note: Windows guest set RTFS_UNIX_MASK bits to 0, which means a default mode * will be set in fOpen. */ fOpen |= ((fMode & RTFS_UNIX_MASK) << RTFILE_O_CREATE_MODE_SHIFT) & RTFILE_O_CREATE_MODE_MASK; } } switch (BIT_FLAG(fShflFlags, SHFL_CF_ACCESS_MASK_RW)) { default: case SHFL_CF_ACCESS_NONE: { /** @todo treat this as read access, but theoretically this could be a no access request. */ fOpen |= RTFILE_O_READ; Log(("FLAG: SHFL_CF_ACCESS_NONE\n")); break; } case SHFL_CF_ACCESS_READ: { fOpen |= RTFILE_O_READ; Log(("FLAG: SHFL_CF_ACCESS_READ\n")); break; } case SHFL_CF_ACCESS_WRITE: { fOpen |= RTFILE_O_WRITE; Log(("FLAG: SHFL_CF_ACCESS_WRITE\n")); break; } case SHFL_CF_ACCESS_READWRITE: { fOpen |= RTFILE_O_READWRITE; Log(("FLAG: SHFL_CF_ACCESS_READWRITE\n")); break; } } if (fShflFlags & SHFL_CF_ACCESS_APPEND) { fOpen |= RTFILE_O_APPEND; } switch (BIT_FLAG(fShflFlags, SHFL_CF_ACCESS_MASK_ATTR)) { default: case SHFL_CF_ACCESS_ATTR_NONE: { fOpen |= RTFILE_O_ACCESS_ATTR_DEFAULT; Log(("FLAG: SHFL_CF_ACCESS_ATTR_NONE\n")); break; } case SHFL_CF_ACCESS_ATTR_READ: { fOpen |= RTFILE_O_ACCESS_ATTR_READ; Log(("FLAG: SHFL_CF_ACCESS_ATTR_READ\n")); break; } case SHFL_CF_ACCESS_ATTR_WRITE: { fOpen |= RTFILE_O_ACCESS_ATTR_WRITE; Log(("FLAG: SHFL_CF_ACCESS_ATTR_WRITE\n")); break; } case SHFL_CF_ACCESS_ATTR_READWRITE: { fOpen |= RTFILE_O_ACCESS_ATTR_READWRITE; Log(("FLAG: SHFL_CF_ACCESS_ATTR_READWRITE\n")); break; } } /* Sharing mask */ switch (BIT_FLAG(fShflFlags, SHFL_CF_ACCESS_MASK_DENY)) { default: case SHFL_CF_ACCESS_DENYNONE: fOpen |= RTFILE_O_DENY_NONE; Log(("FLAG: SHFL_CF_ACCESS_DENYNONE\n")); break; case SHFL_CF_ACCESS_DENYREAD: fOpen |= RTFILE_O_DENY_READ; Log(("FLAG: SHFL_CF_ACCESS_DENYREAD\n")); break; case SHFL_CF_ACCESS_DENYWRITE: fOpen |= RTFILE_O_DENY_WRITE; Log(("FLAG: SHFL_CF_ACCESS_DENYWRITE\n")); break; case SHFL_CF_ACCESS_DENYALL: fOpen |= RTFILE_O_DENY_ALL; Log(("FLAG: SHFL_CF_ACCESS_DENYALL\n")); break; } /* Open/Create action mask */ switch (BIT_FLAG(fShflFlags, SHFL_CF_ACT_MASK_IF_EXISTS)) { case SHFL_CF_ACT_OPEN_IF_EXISTS: if (SHFL_CF_ACT_CREATE_IF_NEW == BIT_FLAG(fShflFlags, SHFL_CF_ACT_MASK_IF_NEW)) { fOpen |= RTFILE_O_OPEN_CREATE; Log(("FLAGS: SHFL_CF_ACT_OPEN_IF_EXISTS and SHFL_CF_ACT_CREATE_IF_NEW\n")); } else if (SHFL_CF_ACT_FAIL_IF_NEW == BIT_FLAG(fShflFlags, SHFL_CF_ACT_MASK_IF_NEW)) { fOpen |= RTFILE_O_OPEN; Log(("FLAGS: SHFL_CF_ACT_OPEN_IF_EXISTS and SHFL_CF_ACT_FAIL_IF_NEW\n")); } else { Log(("FLAGS: invalid open/create action combination\n")); rc = VERR_INVALID_PARAMETER; } break; case SHFL_CF_ACT_FAIL_IF_EXISTS: if (SHFL_CF_ACT_CREATE_IF_NEW == BIT_FLAG(fShflFlags, SHFL_CF_ACT_MASK_IF_NEW)) { fOpen |= RTFILE_O_CREATE; Log(("FLAGS: SHFL_CF_ACT_FAIL_IF_EXISTS and SHFL_CF_ACT_CREATE_IF_NEW\n")); } else { Log(("FLAGS: invalid open/create action combination\n")); rc = VERR_INVALID_PARAMETER; } break; case SHFL_CF_ACT_REPLACE_IF_EXISTS: if (SHFL_CF_ACT_CREATE_IF_NEW == BIT_FLAG(fShflFlags, SHFL_CF_ACT_MASK_IF_NEW)) { fOpen |= RTFILE_O_CREATE_REPLACE; Log(("FLAGS: SHFL_CF_ACT_REPLACE_IF_EXISTS and SHFL_CF_ACT_CREATE_IF_NEW\n")); } else if (SHFL_CF_ACT_FAIL_IF_NEW == BIT_FLAG(fShflFlags, SHFL_CF_ACT_MASK_IF_NEW)) { fOpen |= RTFILE_O_OPEN | RTFILE_O_TRUNCATE; Log(("FLAGS: SHFL_CF_ACT_REPLACE_IF_EXISTS and SHFL_CF_ACT_FAIL_IF_NEW\n")); } else { Log(("FLAGS: invalid open/create action combination\n")); rc = VERR_INVALID_PARAMETER; } break; case SHFL_CF_ACT_OVERWRITE_IF_EXISTS: if (SHFL_CF_ACT_CREATE_IF_NEW == BIT_FLAG(fShflFlags, SHFL_CF_ACT_MASK_IF_NEW)) { fOpen |= RTFILE_O_CREATE_REPLACE; Log(("FLAGS: SHFL_CF_ACT_OVERWRITE_IF_EXISTS and SHFL_CF_ACT_CREATE_IF_NEW\n")); } else if (SHFL_CF_ACT_FAIL_IF_NEW == BIT_FLAG(fShflFlags, SHFL_CF_ACT_MASK_IF_NEW)) { fOpen |= RTFILE_O_OPEN | RTFILE_O_TRUNCATE; Log(("FLAGS: SHFL_CF_ACT_OVERWRITE_IF_EXISTS and SHFL_CF_ACT_FAIL_IF_NEW\n")); } else { Log(("FLAGS: invalid open/create action combination\n")); rc = VERR_INVALID_PARAMETER; } break; default: rc = VERR_INVALID_PARAMETER; Log(("FLAG: SHFL_CF_ACT_MASK_IF_EXISTS - invalid parameter\n")); } if (RT_SUCCESS(rc)) { *pfOpen = fOpen; } return rc; } /** * Open a file or create and open a new one. * * @returns IPRT status code * @param pClient Data structure describing the client accessing the shared folder * @param pszPath Path to the file or folder on the host. * @param pParms->CreateFlags Creation or open parameters, see include/VBox/shflsvc.h * @param pParms->Info When a new file is created this specifies the initial parameters. * When a file is created or overwritten, it also specifies the * initial size. * @retval pParms->Result Shared folder status code, see include/VBox/shflsvc.h * @retval pParms->Handle On success the (shared folder) handle of the file opened or * created * @retval pParms->Info On success the parameters of the file opened or created */ static int vbsfOpenFile(SHFLCLIENTDATA *pClient, const char *pszPath, SHFLCREATEPARMS *pParms) { LogFlow(("vbsfOpenFile: pszPath = %s, pParms = %p\n", pszPath, pParms)); Log(("SHFL create flags %08x\n", pParms->CreateFlags)); SHFLHANDLE handle = SHFL_HANDLE_NIL; SHFLFILEHANDLE *pHandle = 0; /* Open or create a file. */ uint32_t fOpen = 0; bool fNoError = false; static int cErrors; int rc = vbsfConvertFileOpenFlags(pParms->CreateFlags, pParms->Info.Attr.fMode, pParms->Handle, &fOpen); if (RT_SUCCESS(rc)) { rc = VERR_NO_MEMORY; /* Default error. */ handle = vbsfAllocFileHandle(pClient); if (handle != SHFL_HANDLE_NIL) { pHandle = vbsfQueryFileHandle(pClient, handle); if (pHandle) { rc = RTFileOpen(&pHandle->file.Handle, pszPath, fOpen); } } } if (RT_FAILURE(rc)) { switch (rc) { case VERR_FILE_NOT_FOUND: pParms->Result = SHFL_FILE_NOT_FOUND; /* This actually isn't an error, so correct the rc before return later, because the driver (VBoxSF.sys) expects rc = VINF_SUCCESS and checks the result code. */ fNoError = true; break; case VERR_PATH_NOT_FOUND: pParms->Result = SHFL_PATH_NOT_FOUND; /* This actually isn't an error, so correct the rc before return later, because the driver (VBoxSF.sys) expects rc = VINF_SUCCESS and checks the result code. */ fNoError = true; break; case VERR_ALREADY_EXISTS: RTFSOBJINFO info; /** @todo Possible race left here. */ if (RT_SUCCESS(RTPathQueryInfoEx(pszPath, &info, RTFSOBJATTRADD_NOTHING, SHFL_RT_LINK(pClient)))) { #ifdef RT_OS_WINDOWS info.Attr.fMode |= 0111; #endif vbfsCopyFsObjInfoFromIprt(&pParms->Info, &info); } pParms->Result = SHFL_FILE_EXISTS; /* This actually isn't an error, so correct the rc before return later, because the driver (VBoxSF.sys) expects rc = VINF_SUCCESS and checks the result code. */ fNoError = true; break; case VERR_TOO_MANY_OPEN_FILES: if (cErrors < 32) { LogRel(("SharedFolders host service: Cannot open '%s' -- too many open files.\n", pszPath)); #if defined RT_OS_LINUX || RT_OS_SOLARIS if (cErrors < 1) LogRel(("SharedFolders host service: Try to increase the limit for open files (ulimit -n)\n")); #endif cErrors++; } pParms->Result = SHFL_NO_RESULT; break; default: pParms->Result = SHFL_NO_RESULT; } } else { /** @note The shared folder status code is very approximate, as the runtime * does not really provide this information. */ pParms->Result = SHFL_FILE_EXISTS; /* We lost the information as to whether it was created when we eliminated the race. */ if ( ( SHFL_CF_ACT_REPLACE_IF_EXISTS == BIT_FLAG(pParms->CreateFlags, SHFL_CF_ACT_MASK_IF_EXISTS)) || ( SHFL_CF_ACT_OVERWRITE_IF_EXISTS == BIT_FLAG(pParms->CreateFlags, SHFL_CF_ACT_MASK_IF_EXISTS))) { /* For now, we do not treat a failure here as fatal. */ /* @todo Also set the size for SHFL_CF_ACT_CREATE_IF_NEW if SHFL_CF_ACT_FAIL_IF_EXISTS is set. */ RTFileSetSize(pHandle->file.Handle, pParms->Info.cbObject); pParms->Result = SHFL_FILE_REPLACED; } if ( ( SHFL_CF_ACT_FAIL_IF_EXISTS == BIT_FLAG(pParms->CreateFlags, SHFL_CF_ACT_MASK_IF_EXISTS)) || ( SHFL_CF_ACT_CREATE_IF_NEW == BIT_FLAG(pParms->CreateFlags, SHFL_CF_ACT_MASK_IF_NEW))) { pParms->Result = SHFL_FILE_CREATED; } #if 0 /* @todo */ /* Set new attributes. */ if ( ( SHFL_CF_ACT_REPLACE_IF_EXISTS == BIT_FLAG(pParms->CreateFlags, SHFL_CF_ACT_MASK_IF_EXISTS)) || ( SHFL_CF_ACT_CREATE_IF_NEW == BIT_FLAG(pParms->CreateFlags, SHFL_CF_ACT_MASK_IF_NEW))) { RTFileSetTimes(pHandle->file.Handle, &pParms->Info.AccessTime, &pParms->Info.ModificationTime, &pParms->Info.ChangeTime, &pParms->Info.BirthTime ); RTFileSetMode (pHandle->file.Handle, pParms->Info.Attr.fMode); } #endif RTFSOBJINFO info; /* Get file information */ rc = RTFileQueryInfo(pHandle->file.Handle, &info, RTFSOBJATTRADD_NOTHING); if (RT_SUCCESS(rc)) { #ifdef RT_OS_WINDOWS info.Attr.fMode |= 0111; #endif vbfsCopyFsObjInfoFromIprt(&pParms->Info, &info); } } /* Free resources if any part of the function has failed. */ if (RT_FAILURE(rc)) { if ( (0 != pHandle) && (NIL_RTFILE != pHandle->file.Handle) && (0 != pHandle->file.Handle)) { RTFileClose(pHandle->file.Handle); pHandle->file.Handle = NIL_RTFILE; } if (SHFL_HANDLE_NIL != handle) { vbsfFreeFileHandle(pClient, handle); } pParms->Handle = SHFL_HANDLE_NIL; } else { pParms->Handle = handle; } /* Report the driver that all is okay, we're done here */ if (fNoError) rc = VINF_SUCCESS; LogFlow(("vbsfOpenFile: rc = %Rrc\n", rc)); return rc; } /** * Open a folder or create and open a new one. * * @returns IPRT status code * @param pszPath Path to the file or folder on the host. * @param pParms->CreateFlags Creation or open parameters, see include/VBox/shflsvc.h * @retval pParms->Result Shared folder status code, see include/VBox/shflsvc.h * @retval pParms->Handle On success the (shared folder) handle of the folder opened or * created * @retval pParms->Info On success the parameters of the folder opened or created * * @note folders are created with fMode = 0777 */ static int vbsfOpenDir(SHFLCLIENTDATA *pClient, const char *pszPath, SHFLCREATEPARMS *pParms) { LogFlow(("vbsfOpenDir: pszPath = %s, pParms = %p\n", pszPath, pParms)); Log(("SHFL create flags %08x\n", pParms->CreateFlags)); int rc = VERR_NO_MEMORY; SHFLHANDLE handle = vbsfAllocDirHandle(pClient); SHFLFILEHANDLE *pHandle = vbsfQueryDirHandle(pClient, handle); if (0 != pHandle) { rc = VINF_SUCCESS; pParms->Result = SHFL_FILE_EXISTS; /* May be overwritten with SHFL_FILE_CREATED. */ /** @todo Can anyone think of a sensible, race-less way to do this? Although I suspect that the race is inherent, due to the API available... */ /* Try to create the folder first if "create if new" is specified. If this fails, and "open if exists" is specified, then we ignore the failure and try to open the folder anyway. */ if ( SHFL_CF_ACT_CREATE_IF_NEW == BIT_FLAG(pParms->CreateFlags, SHFL_CF_ACT_MASK_IF_NEW)) { /** @todo render supplied attributes. * bird: The guest should specify this. For windows guests RTFS_DOS_DIRECTORY should suffice. */ RTFMODE fMode = 0777; pParms->Result = SHFL_FILE_CREATED; rc = RTDirCreate(pszPath, fMode, 0); if (RT_FAILURE(rc)) { switch (rc) { case VERR_ALREADY_EXISTS: pParms->Result = SHFL_FILE_EXISTS; break; case VERR_PATH_NOT_FOUND: pParms->Result = SHFL_PATH_NOT_FOUND; break; default: pParms->Result = SHFL_NO_RESULT; } } } if ( RT_SUCCESS(rc) || (SHFL_CF_ACT_OPEN_IF_EXISTS == BIT_FLAG(pParms->CreateFlags, SHFL_CF_ACT_MASK_IF_EXISTS))) { /* Open the directory now */ rc = RTDirOpenFiltered(&pHandle->dir.Handle, pszPath, RTDIRFILTER_NONE, 0); if (RT_SUCCESS(rc)) { RTFSOBJINFO info; rc = RTDirQueryInfo(pHandle->dir.Handle, &info, RTFSOBJATTRADD_NOTHING); if (RT_SUCCESS(rc)) { vbfsCopyFsObjInfoFromIprt(&pParms->Info, &info); } } else { switch (rc) { case VERR_FILE_NOT_FOUND: /* Does this make sense? */ pParms->Result = SHFL_FILE_NOT_FOUND; break; case VERR_PATH_NOT_FOUND: pParms->Result = SHFL_PATH_NOT_FOUND; break; case VERR_ACCESS_DENIED: pParms->Result = SHFL_FILE_EXISTS; break; default: pParms->Result = SHFL_NO_RESULT; } } } } if (RT_FAILURE(rc)) { if ( (0 != pHandle) && (0 != pHandle->dir.Handle)) { RTDirClose(pHandle->dir.Handle); pHandle->dir.Handle = 0; } if (SHFL_HANDLE_NIL != handle) { vbsfFreeFileHandle(pClient, handle); } pParms->Handle = SHFL_HANDLE_NIL; } else { pParms->Handle = handle; } LogFlow(("vbsfOpenDir: rc = %Rrc\n", rc)); return rc; } static int vbsfCloseDir(SHFLFILEHANDLE *pHandle) { int rc = VINF_SUCCESS; LogFlow(("vbsfCloseDir: Handle = %08X Search Handle = %08X\n", pHandle->dir.Handle, pHandle->dir.SearchHandle)); RTDirClose(pHandle->dir.Handle); if (pHandle->dir.SearchHandle) RTDirClose(pHandle->dir.SearchHandle); if (pHandle->dir.pLastValidEntry) { RTMemFree(pHandle->dir.pLastValidEntry); pHandle->dir.pLastValidEntry = NULL; } LogFlow(("vbsfCloseDir: rc = %d\n", rc)); return rc; } static int vbsfCloseFile(SHFLFILEHANDLE *pHandle) { int rc = VINF_SUCCESS; LogFlow(("vbsfCloseFile: Handle = %08X\n", pHandle->file.Handle)); rc = RTFileClose(pHandle->file.Handle); LogFlow(("vbsfCloseFile: rc = %d\n", rc)); return rc; } /** * Look up file or folder information by host path. * * @returns iprt status code (currently VINF_SUCCESS) * @param pszFullPath The path of the file to be looked up * @retval pParms->Result Status of the operation (success or error) * @retval pParms->Info On success, information returned about the file */ static int vbsfLookupFile(SHFLCLIENTDATA *pClient, char *pszPath, SHFLCREATEPARMS *pParms) { RTFSOBJINFO info; int rc; rc = RTPathQueryInfoEx(pszPath, &info, RTFSOBJATTRADD_NOTHING, SHFL_RT_LINK(pClient)); LogFlow(("SHFL_CF_LOOKUP\n")); /* Client just wants to know if the object exists. */ switch (rc) { case VINF_SUCCESS: { #ifdef RT_OS_WINDOWS info.Attr.fMode |= 0111; #endif vbfsCopyFsObjInfoFromIprt(&pParms->Info, &info); pParms->Result = SHFL_FILE_EXISTS; break; } case VERR_FILE_NOT_FOUND: { pParms->Result = SHFL_FILE_NOT_FOUND; rc = VINF_SUCCESS; break; } case VERR_PATH_NOT_FOUND: { pParms->Result = SHFL_PATH_NOT_FOUND; rc = VINF_SUCCESS; break; } } pParms->Handle = SHFL_HANDLE_NIL; return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_CREATE API. Located here as a form of API * documentation. */ void testCreate(RTTEST hTest) { /* Simple opening of an existing file. */ testCreateFileSimple(hTest); /* Simple opening of an existing directory. */ /** @todo How do wildcards in the path name work? */ testCreateDirSimple(hTest); /* If the number or types of parameters are wrong the API should fail. */ testCreateBadParameters(hTest); /* Add tests as required... */ } #endif /** * Create or open a file or folder. Perform character set and case * conversion on the file name if necessary. * * @returns IPRT status code, but see note below * @param pClient Data structure describing the client accessing the shared * folder * @param root The index of the shared folder in the table of mappings. * The host path of the shared folder is found using this. * @param pPath The path of the file or folder relative to the host path * indexed by root. * @param cbPath Presumably the length of the path in pPath. Actually * ignored, as pPath contains a length parameter. * @param pParms->Info If a new file is created or an old one overwritten, set * these attributes * @retval pParms->Result Shared folder result code, see include/VBox/shflsvc.h * @retval pParms->Handle Shared folder handle to the newly opened file * @retval pParms->Info Attributes of the file or folder opened * * @note This function returns success if a "non-exceptional" error occurred, * such as "no such file". In this case, the caller should check the * pParms->Result return value and whether pParms->Handle is valid. */ int vbsfCreate(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLSTRING *pPath, uint32_t cbPath, SHFLCREATEPARMS *pParms) { int rc = VINF_SUCCESS; LogFlow(("vbsfCreate: pClient = %p, pPath = %p, cbPath = %d, pParms = %p CreateFlags=%x\n", pClient, pPath, cbPath, pParms, pParms->CreateFlags)); /* Check the client access rights to the root. */ /** @todo */ /* Build a host full path for the given path, handle file name case issues (if the guest * expects case-insensitive paths but the host is case-sensitive) and convert ucs2 to utf8 if * necessary. */ char *pszFullPath = NULL; uint32_t cbFullPathRoot = 0; rc = vbsfBuildFullPath(pClient, root, pPath, cbPath, &pszFullPath, &cbFullPathRoot); if (RT_SUCCESS(rc)) { /* Reset return value in case client forgot to do so. * pParms->Handle must not be reset here, as it is used * in vbsfOpenFile to detect old additions. */ pParms->Result = SHFL_NO_RESULT; if (BIT_FLAG(pParms->CreateFlags, SHFL_CF_LOOKUP)) { rc = vbsfLookupFile(pClient, pszFullPath, pParms); } else { /* Query path information. */ RTFSOBJINFO info; rc = RTPathQueryInfoEx(pszFullPath, &info, RTFSOBJATTRADD_NOTHING, SHFL_RT_LINK(pClient)); LogFlow(("RTPathQueryInfoEx returned %Rrc\n", rc)); if (RT_SUCCESS(rc)) { /* Mark it as a directory in case the caller didn't. */ /** * @todo I left this in in order not to change the behaviour of the * function too much. Is it really needed, and should it really be * here? */ if (BIT_FLAG(info.Attr.fMode, RTFS_DOS_DIRECTORY)) { pParms->CreateFlags |= SHFL_CF_DIRECTORY; } /** * @todo This should be in the Windows Guest Additions, as no-one else * needs it. */ if (BIT_FLAG(pParms->CreateFlags, SHFL_CF_OPEN_TARGET_DIRECTORY)) { vbsfStripLastComponent(pszFullPath, cbFullPathRoot); pParms->CreateFlags &= ~SHFL_CF_ACT_MASK_IF_EXISTS; pParms->CreateFlags &= ~SHFL_CF_ACT_MASK_IF_NEW; pParms->CreateFlags |= SHFL_CF_DIRECTORY; pParms->CreateFlags |= SHFL_CF_ACT_OPEN_IF_EXISTS; pParms->CreateFlags |= SHFL_CF_ACT_FAIL_IF_NEW; } } rc = VINF_SUCCESS; /* Note: do not check the SHFL_CF_ACCESS_WRITE here, only check if the open operation * will cause changes. * * Actual operations (write, set attr, etc), which can write to a shared folder, have * the check and will return VERR_WRITE_PROTECT if the folder is not writable. */ if ( (pParms->CreateFlags & SHFL_CF_ACT_MASK_IF_EXISTS) == SHFL_CF_ACT_REPLACE_IF_EXISTS || (pParms->CreateFlags & SHFL_CF_ACT_MASK_IF_EXISTS) == SHFL_CF_ACT_OVERWRITE_IF_EXISTS || (pParms->CreateFlags & SHFL_CF_ACT_MASK_IF_NEW) == SHFL_CF_ACT_CREATE_IF_NEW ) { /* is the guest allowed to write to this share? */ bool fWritable; rc = vbsfMappingsQueryWritable(pClient, root, &fWritable); if (RT_FAILURE(rc) || !fWritable) rc = VERR_WRITE_PROTECT; } if (RT_SUCCESS(rc)) { if (BIT_FLAG(pParms->CreateFlags, SHFL_CF_DIRECTORY)) { rc = vbsfOpenDir(pClient, pszFullPath, pParms); } else { rc = vbsfOpenFile(pClient, pszFullPath, pParms); } } else { pParms->Handle = SHFL_HANDLE_NIL; } } /* free the path string */ vbsfFreeFullPath(pszFullPath); } Log(("vbsfCreate: handle = %RX64 rc = %Rrc result=%x\n", (uint64_t)pParms->Handle, rc, pParms->Result)); return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_CLOSE API. Located here as a form of API * documentation. */ void testClose(RTTEST hTest) { /* If the API parameters are invalid the API should fail. */ testCloseBadParameters(hTest); /* Add tests as required... */ } #endif int vbsfClose(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle) { int rc = VINF_SUCCESS; LogFlow(("vbsfClose: pClient = %p, Handle = %RX64\n", pClient, Handle)); uint32_t type = vbsfQueryHandleType(pClient, Handle); Assert((type & ~(SHFL_HF_TYPE_DIR | SHFL_HF_TYPE_FILE)) == 0); switch (type & (SHFL_HF_TYPE_DIR | SHFL_HF_TYPE_FILE)) { case SHFL_HF_TYPE_DIR: { rc = vbsfCloseDir(vbsfQueryDirHandle(pClient, Handle)); break; } case SHFL_HF_TYPE_FILE: { rc = vbsfCloseFile(vbsfQueryFileHandle(pClient, Handle)); break; } default: return VERR_INVALID_HANDLE; } vbsfFreeFileHandle(pClient, Handle); Log(("vbsfClose: rc = %Rrc\n", rc)); return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_READ API. Located here as a form of API * documentation. */ void testRead(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testReadBadParameters(hTest); /* Basic reading from a file. */ testReadFileSimple(hTest); /* Add tests as required... */ } #endif int vbsfRead (SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint64_t offset, uint32_t *pcbBuffer, uint8_t *pBuffer) { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); size_t count = 0; int rc; if (pHandle == 0 || pcbBuffer == 0 || pBuffer == 0) { AssertFailed(); return VERR_INVALID_PARAMETER; } Log(("vbsfRead %RX64 offset %RX64 bytes %x\n", Handle, offset, *pcbBuffer)); if (*pcbBuffer == 0) return VINF_SUCCESS; /* @todo correct? */ rc = RTFileSeek(pHandle->file.Handle, offset, RTFILE_SEEK_BEGIN, NULL); if (rc != VINF_SUCCESS) { AssertRC(rc); return rc; } rc = RTFileRead(pHandle->file.Handle, pBuffer, *pcbBuffer, &count); *pcbBuffer = (uint32_t)count; Log(("RTFileRead returned %Rrc bytes read %x\n", rc, count)); return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_WRITE API. Located here as a form of API * documentation. */ void testWrite(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testWriteBadParameters(hTest); /* Simple test of writing to a file. */ testWriteFileSimple(hTest); /* Add tests as required... */ } #endif int vbsfWrite(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint64_t offset, uint32_t *pcbBuffer, uint8_t *pBuffer) { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); size_t count = 0; int rc; if (pHandle == 0 || pcbBuffer == 0 || pBuffer == 0) { AssertFailed(); return VERR_INVALID_PARAMETER; } Log(("vbsfWrite %RX64 offset %RX64 bytes %x\n", Handle, offset, *pcbBuffer)); /* Is the guest allowed to write to this share? * XXX Actually this check was still done in vbsfCreate() -- RTFILE_O_WRITE cannot be set if vbsfMappingsQueryWritable() failed. */ bool fWritable; rc = vbsfMappingsQueryWritable(pClient, root, &fWritable); if (RT_FAILURE(rc) || !fWritable) return VERR_WRITE_PROTECT; if (*pcbBuffer == 0) return VINF_SUCCESS; /** @todo correct? */ rc = RTFileSeek(pHandle->file.Handle, offset, RTFILE_SEEK_BEGIN, NULL); if (rc != VINF_SUCCESS) { AssertRC(rc); return rc; } rc = RTFileWrite(pHandle->file.Handle, pBuffer, *pcbBuffer, &count); *pcbBuffer = (uint32_t)count; Log(("RTFileWrite returned %Rrc bytes written %x\n", rc, count)); return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_FLUSH API. Located here as a form of API * documentation. */ void testFlush(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testFlushBadParameters(hTest); /* Simple opening and flushing of a file. */ testFlushFileSimple(hTest); /* Add tests as required... */ } #endif int vbsfFlush(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle) { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); int rc = VINF_SUCCESS; if (pHandle == 0) { AssertFailed(); return VERR_INVALID_HANDLE; } Log(("vbsfFlush %RX64\n", Handle)); rc = RTFileFlush(pHandle->file.Handle); AssertRC(rc); return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_LIST API. Located here as a form of API * documentation. */ void testDirList(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testDirListBadParameters(hTest); /* Test listing an empty directory (simple edge case). */ testDirListEmpty(hTest); /* Add tests as required... */ } #endif int vbsfDirList(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, SHFLSTRING *pPath, uint32_t flags, uint32_t *pcbBuffer, uint8_t *pBuffer, uint32_t *pIndex, uint32_t *pcFiles) { SHFLFILEHANDLE *pHandle = vbsfQueryDirHandle(pClient, Handle); PRTDIRENTRYEX pDirEntry = 0, pDirEntryOrg; uint32_t cbDirEntry, cbBufferOrg; int rc = VINF_SUCCESS; PSHFLDIRINFO pSFDEntry; PRTUTF16 pwszString; PRTDIR DirHandle; bool fUtf8; fUtf8 = BIT_FLAG(pClient->fu32Flags, SHFL_CF_UTF8) != 0; if (pHandle == 0 || pcbBuffer == 0 || pBuffer == 0) { AssertFailed(); return VERR_INVALID_PARAMETER; } Assert(pIndex && *pIndex == 0); DirHandle = pHandle->dir.Handle; cbDirEntry = 4096; pDirEntryOrg = pDirEntry = (PRTDIRENTRYEX)RTMemAlloc(cbDirEntry); if (pDirEntry == 0) { AssertFailed(); return VERR_NO_MEMORY; } cbBufferOrg = *pcbBuffer; *pcbBuffer = 0; pSFDEntry = (PSHFLDIRINFO)pBuffer; *pIndex = 1; /* not yet complete */ *pcFiles = 0; if (pPath) { if (pHandle->dir.SearchHandle == 0) { /* Build a host full path for the given path * and convert ucs2 to utf8 if necessary. */ char *pszFullPath = NULL; Assert(pHandle->dir.pLastValidEntry == 0); rc = vbsfBuildFullPath(pClient, root, pPath, pPath->u16Size, &pszFullPath, NULL, true); if (RT_SUCCESS(rc)) { rc = RTDirOpenFiltered(&pHandle->dir.SearchHandle, pszFullPath, RTDIRFILTER_WINNT, 0); /* free the path string */ vbsfFreeFullPath(pszFullPath); if (RT_FAILURE(rc)) goto end; } else goto end; } Assert(pHandle->dir.SearchHandle); DirHandle = pHandle->dir.SearchHandle; } while (cbBufferOrg) { size_t cbDirEntrySize = cbDirEntry; uint32_t cbNeeded; /* Do we still have a valid last entry for the active search? If so, then return it here */ if (pHandle->dir.pLastValidEntry) { pDirEntry = pHandle->dir.pLastValidEntry; } else { pDirEntry = pDirEntryOrg; rc = RTDirReadEx(DirHandle, pDirEntry, &cbDirEntrySize, RTFSOBJATTRADD_NOTHING, SHFL_RT_LINK(pClient)); if (rc == VERR_NO_MORE_FILES) { *pIndex = 0; /* listing completed */ break; } if ( rc != VINF_SUCCESS && rc != VWRN_NO_DIRENT_INFO) { //AssertFailed(); if ( rc == VERR_NO_TRANSLATION || rc == VERR_INVALID_UTF8_ENCODING) continue; break; } } cbNeeded = RT_OFFSETOF(SHFLDIRINFO, name.String); if (fUtf8) cbNeeded += pDirEntry->cbName + 1; else /* Overestimating, but that's ok */ cbNeeded += (pDirEntry->cbName + 1) * 2; if (cbBufferOrg < cbNeeded) { /* No room, so save this directory entry, or else it's lost forever */ pHandle->dir.pLastValidEntry = pDirEntry; if (*pcFiles == 0) { AssertFailed(); return VINF_BUFFER_OVERFLOW; /* Return directly and don't free pDirEntry */ } return VINF_SUCCESS; /* Return directly and don't free pDirEntry */ } #ifdef RT_OS_WINDOWS pDirEntry->Info.Attr.fMode |= 0111; #endif vbfsCopyFsObjInfoFromIprt(&pSFDEntry->Info, &pDirEntry->Info); pSFDEntry->cucShortName = 0; if (fUtf8) { void *src, *dst; src = &pDirEntry->szName[0]; dst = &pSFDEntry->name.String.utf8[0]; memcpy(dst, src, pDirEntry->cbName + 1); pSFDEntry->name.u16Size = pDirEntry->cbName + 1; pSFDEntry->name.u16Length = pDirEntry->cbName; } else { pSFDEntry->name.String.ucs2[0] = 0; pwszString = pSFDEntry->name.String.ucs2; int rc2 = RTStrToUtf16Ex(pDirEntry->szName, RTSTR_MAX, &pwszString, pDirEntry->cbName+1, NULL); AssertRC(rc2); #ifdef RT_OS_DARWIN /** @todo This belongs in rtPathToNative or in the windows shared folder file system driver... * The question is simply whether the NFD normalization is actually applied on a (virtual) file * system level in darwin, or just by the user mode application libs. */ { // Convert to // Normalization Form C (composed Unicode). We need this because // Mac OS X file system uses NFD (Normalization Form D :decomposed Unicode) // while most other OS', server-side programs usually expect NFC. uint16_t ucs2Length; CFRange rangeCharacters; CFMutableStringRef inStr = ::CFStringCreateMutable(NULL, 0); ::CFStringAppendCharacters(inStr, (UniChar *)pwszString, RTUtf16Len(pwszString)); ::CFStringNormalize(inStr, kCFStringNormalizationFormC); ucs2Length = ::CFStringGetLength(inStr); rangeCharacters.location = 0; rangeCharacters.length = ucs2Length; ::CFStringGetCharacters(inStr, rangeCharacters, pwszString); pwszString[ucs2Length] = 0x0000; // NULL terminated CFRelease(inStr); } #endif pSFDEntry->name.u16Length = (uint32_t)RTUtf16Len(pSFDEntry->name.String.ucs2) * 2; pSFDEntry->name.u16Size = pSFDEntry->name.u16Length + 2; Log(("SHFL: File name size %d\n", pSFDEntry->name.u16Size)); Log(("SHFL: File name %ls\n", &pSFDEntry->name.String.ucs2)); // adjust cbNeeded (it was overestimated before) cbNeeded = RT_OFFSETOF(SHFLDIRINFO, name.String) + pSFDEntry->name.u16Size; } pSFDEntry = (PSHFLDIRINFO)((uintptr_t)pSFDEntry + cbNeeded); *pcbBuffer += cbNeeded; cbBufferOrg-= cbNeeded; *pcFiles += 1; /* Free the saved last entry, that we've just returned */ if (pHandle->dir.pLastValidEntry) { RTMemFree(pHandle->dir.pLastValidEntry); pHandle->dir.pLastValidEntry = NULL; } if (flags & SHFL_LIST_RETURN_ONE) break; /* we're done */ } Assert(rc != VINF_SUCCESS || *pcbBuffer > 0); end: if (pDirEntry) RTMemFree(pDirEntry); return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_READLINK API. Located here as a form of API * documentation. */ void testReadLink(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testReadLinkBadParameters(hTest); /* Add tests as required... */ } #endif int vbsfReadLink(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLSTRING *pPath, uint32_t cbPath, uint8_t *pBuffer, uint32_t cbBuffer) { int rc = VINF_SUCCESS; if (pPath == 0 || pBuffer == 0) { AssertFailed(); return VERR_INVALID_PARAMETER; } /* Build a host full path for the given path, handle file name case issues * (if the guest expects case-insensitive paths but the host is * case-sensitive) and convert ucs2 to utf8 if necessary. */ char *pszFullPath = NULL; uint32_t cbFullPathRoot = 0; rc = vbsfBuildFullPath(pClient, root, pPath, cbPath, &pszFullPath, &cbFullPathRoot); if (RT_SUCCESS(rc)) { rc = RTSymlinkRead(pszFullPath, (char *) pBuffer, cbBuffer, 0); /* free the path string */ vbsfFreeFullPath(pszFullPath); } return rc; } int vbsfQueryFileInfo(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint32_t flags, uint32_t *pcbBuffer, uint8_t *pBuffer) { uint32_t type = vbsfQueryHandleType(pClient, Handle); int rc = VINF_SUCCESS; SHFLFSOBJINFO *pObjInfo = (SHFLFSOBJINFO *)pBuffer; RTFSOBJINFO fileinfo; if ( !(type == SHFL_HF_TYPE_DIR || type == SHFL_HF_TYPE_FILE) || pcbBuffer == 0 || pObjInfo == 0 || *pcbBuffer < sizeof(SHFLFSOBJINFO)) { AssertFailed(); return VERR_INVALID_PARAMETER; } /* @todo other options */ Assert(flags == (SHFL_INFO_GET|SHFL_INFO_FILE)); *pcbBuffer = 0; if (type == SHFL_HF_TYPE_DIR) { SHFLFILEHANDLE *pHandle = vbsfQueryDirHandle(pClient, Handle); rc = RTDirQueryInfo(pHandle->dir.Handle, &fileinfo, RTFSOBJATTRADD_NOTHING); } else { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); rc = RTFileQueryInfo(pHandle->file.Handle, &fileinfo, RTFSOBJATTRADD_NOTHING); #ifdef RT_OS_WINDOWS if (RT_SUCCESS(rc) && RTFS_IS_FILE(pObjInfo->Attr.fMode)) pObjInfo->Attr.fMode |= 0111; #endif } if (rc == VINF_SUCCESS) { vbfsCopyFsObjInfoFromIprt(pObjInfo, &fileinfo); *pcbBuffer = sizeof(SHFLFSOBJINFO); } else AssertFailed(); return rc; } static int vbsfSetFileInfo(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint32_t flags, uint32_t *pcbBuffer, uint8_t *pBuffer) { uint32_t type = vbsfQueryHandleType(pClient, Handle); int rc = VINF_SUCCESS; SHFLFSOBJINFO *pSFDEntry; if ( !(type == SHFL_HF_TYPE_DIR || type == SHFL_HF_TYPE_FILE) || pcbBuffer == 0 || pBuffer == 0 || *pcbBuffer < sizeof(SHFLFSOBJINFO)) { AssertFailed(); return VERR_INVALID_PARAMETER; } *pcbBuffer = 0; pSFDEntry = (SHFLFSOBJINFO *)pBuffer; Assert(flags == (SHFL_INFO_SET | SHFL_INFO_FILE)); /* Change only the time values that are not zero */ if (type == SHFL_HF_TYPE_DIR) { SHFLFILEHANDLE *pHandle = vbsfQueryDirHandle(pClient, Handle); rc = RTDirSetTimes(pHandle->dir.Handle, (RTTimeSpecGetNano(&pSFDEntry->AccessTime)) ? &pSFDEntry->AccessTime : NULL, (RTTimeSpecGetNano(&pSFDEntry->ModificationTime)) ? &pSFDEntry->ModificationTime: NULL, (RTTimeSpecGetNano(&pSFDEntry->ChangeTime)) ? &pSFDEntry->ChangeTime: NULL, (RTTimeSpecGetNano(&pSFDEntry->BirthTime)) ? &pSFDEntry->BirthTime: NULL ); } else { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); rc = RTFileSetTimes(pHandle->file.Handle, (RTTimeSpecGetNano(&pSFDEntry->AccessTime)) ? &pSFDEntry->AccessTime : NULL, (RTTimeSpecGetNano(&pSFDEntry->ModificationTime)) ? &pSFDEntry->ModificationTime: NULL, (RTTimeSpecGetNano(&pSFDEntry->ChangeTime)) ? &pSFDEntry->ChangeTime: NULL, (RTTimeSpecGetNano(&pSFDEntry->BirthTime)) ? &pSFDEntry->BirthTime: NULL ); } if (rc != VINF_SUCCESS) { Log(("RTFileSetTimes failed with %Rrc\n", rc)); Log(("AccessTime %RX64\n", RTTimeSpecGetNano(&pSFDEntry->AccessTime))); Log(("ModificationTime %RX64\n", RTTimeSpecGetNano(&pSFDEntry->ModificationTime))); Log(("ChangeTime %RX64\n", RTTimeSpecGetNano(&pSFDEntry->ChangeTime))); Log(("BirthTime %RX64\n", RTTimeSpecGetNano(&pSFDEntry->BirthTime))); /* temporary hack */ rc = VINF_SUCCESS; } if (type == SHFL_HF_TYPE_FILE) { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); /* Change file attributes if necessary */ if (pSFDEntry->Attr.fMode) { RTFMODE fMode = pSFDEntry->Attr.fMode; #ifndef RT_OS_WINDOWS /* Don't allow the guest to clear the own bit, otherwise the guest wouldn't be * able to access this file anymore. Only for guests, which set the UNIX mode. */ if (fMode & RTFS_UNIX_MASK) fMode |= RTFS_UNIX_IRUSR; #endif rc = RTFileSetMode(pHandle->file.Handle, fMode); if (rc != VINF_SUCCESS) { Log(("RTFileSetMode %x failed with %Rrc\n", fMode, rc)); /* silent failure, because this tends to fail with e.g. windows guest & linux host */ rc = VINF_SUCCESS; } } } /* TODO: mode for directories */ if (rc == VINF_SUCCESS) { uint32_t bufsize = sizeof(*pSFDEntry); rc = vbsfQueryFileInfo(pClient, root, Handle, SHFL_INFO_GET|SHFL_INFO_FILE, &bufsize, (uint8_t *)pSFDEntry); if (rc == VINF_SUCCESS) { *pcbBuffer = sizeof(SHFLFSOBJINFO); } else AssertFailed(); } return rc; } static int vbsfSetEndOfFile(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint32_t flags, uint32_t *pcbBuffer, uint8_t *pBuffer) { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); int rc = VINF_SUCCESS; SHFLFSOBJINFO *pSFDEntry; if (pHandle == 0 || pcbBuffer == 0 || pBuffer == 0 || *pcbBuffer < sizeof(SHFLFSOBJINFO)) { AssertFailed(); return VERR_INVALID_PARAMETER; } *pcbBuffer = 0; pSFDEntry = (SHFLFSOBJINFO *)pBuffer; if (flags & SHFL_INFO_SIZE) { rc = RTFileSetSize(pHandle->file.Handle, pSFDEntry->cbObject); if (rc != VINF_SUCCESS) AssertFailed(); } else AssertFailed(); if (rc == VINF_SUCCESS) { RTFSOBJINFO fileinfo; /* Query the new object info and return it */ rc = RTFileQueryInfo(pHandle->file.Handle, &fileinfo, RTFSOBJATTRADD_NOTHING); if (rc == VINF_SUCCESS) { #ifdef RT_OS_WINDOWS fileinfo.Attr.fMode |= 0111; #endif vbfsCopyFsObjInfoFromIprt(pSFDEntry, &fileinfo); *pcbBuffer = sizeof(SHFLFSOBJINFO); } else AssertFailed(); } return rc; } int vbsfQueryVolumeInfo(SHFLCLIENTDATA *pClient, SHFLROOT root, uint32_t flags, uint32_t *pcbBuffer, uint8_t *pBuffer) { int rc = VINF_SUCCESS; SHFLVOLINFO *pSFDEntry; char *pszFullPath = NULL; SHFLSTRING dummy; if (pcbBuffer == 0 || pBuffer == 0 || *pcbBuffer < sizeof(SHFLVOLINFO)) { AssertFailed(); return VERR_INVALID_PARAMETER; } /* @todo other options */ Assert(flags == (SHFL_INFO_GET|SHFL_INFO_VOLUME)); *pcbBuffer = 0; pSFDEntry = (PSHFLVOLINFO)pBuffer; ShflStringInitBuffer(&dummy, sizeof(dummy)); dummy.String.ucs2[0] = '\0'; rc = vbsfBuildFullPath(pClient, root, &dummy, 0, &pszFullPath, NULL); if (RT_SUCCESS(rc)) { rc = RTFsQuerySizes(pszFullPath, &pSFDEntry->ullTotalAllocationBytes, &pSFDEntry->ullAvailableAllocationBytes, &pSFDEntry->ulBytesPerAllocationUnit, &pSFDEntry->ulBytesPerSector); if (rc != VINF_SUCCESS) goto exit; rc = RTFsQuerySerial(pszFullPath, &pSFDEntry->ulSerial); if (rc != VINF_SUCCESS) goto exit; RTFSPROPERTIES FsProperties; rc = RTFsQueryProperties(pszFullPath, &FsProperties); if (rc != VINF_SUCCESS) goto exit; vbfsCopyFsPropertiesFromIprt(&pSFDEntry->fsProperties, &FsProperties); *pcbBuffer = sizeof(SHFLVOLINFO); } else AssertFailed(); exit: AssertMsg(rc == VINF_SUCCESS, ("failure: rc = %Rrc\n", rc)); /* free the path string */ vbsfFreeFullPath(pszFullPath); return rc; } int vbsfQueryFSInfo(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint32_t flags, uint32_t *pcbBuffer, uint8_t *pBuffer) { if (pcbBuffer == 0 || pBuffer == 0) { AssertFailed(); return VERR_INVALID_PARAMETER; } if (flags & SHFL_INFO_FILE) return vbsfQueryFileInfo(pClient, root, Handle, flags, pcbBuffer, pBuffer); if (flags & SHFL_INFO_VOLUME) return vbsfQueryVolumeInfo(pClient, root, flags, pcbBuffer, pBuffer); AssertFailed(); return VERR_INVALID_PARAMETER; } #ifdef UNITTEST /** Unit test the SHFL_FN_INFORMATION API. Located here as a form of API * documentation. */ void testFSInfo(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testFSInfoBadParameters(hTest); /* Basic get and set file size test. */ testFSInfoQuerySetFMode(hTest); /* Basic get and set dir atime test. */ testFSInfoQuerySetDirATime(hTest); /* Basic get and set file atime test. */ testFSInfoQuerySetFileATime(hTest); /* Basic set end of file. */ testFSInfoQuerySetEndOfFile(hTest); /* Add tests as required... */ } #endif int vbsfSetFSInfo(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint32_t flags, uint32_t *pcbBuffer, uint8_t *pBuffer) { uint32_t type = vbsfQueryHandleType(pClient, Handle) & (SHFL_HF_TYPE_DIR|SHFL_HF_TYPE_FILE|SHFL_HF_TYPE_VOLUME); if (type == 0 || pcbBuffer == 0 || pBuffer == 0) { AssertFailed(); return VERR_INVALID_PARAMETER; } /* is the guest allowed to write to this share? */ bool fWritable; int rc = vbsfMappingsQueryWritable(pClient, root, &fWritable); if (RT_FAILURE(rc) || !fWritable) return VERR_WRITE_PROTECT; if (flags & SHFL_INFO_FILE) return vbsfSetFileInfo(pClient, root, Handle, flags, pcbBuffer, pBuffer); if (flags & SHFL_INFO_SIZE) return vbsfSetEndOfFile(pClient, root, Handle, flags, pcbBuffer, pBuffer); // if (flags & SHFL_INFO_VOLUME) // return vbsfVolumeInfo(pClient, root, Handle, flags, pcbBuffer, pBuffer); AssertFailed(); return VERR_INVALID_PARAMETER; } #ifdef UNITTEST /** Unit test the SHFL_FN_LOCK API. Located here as a form of API * documentation. */ void testLock(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testLockBadParameters(hTest); /* Simple file locking and unlocking test. */ testLockFileSimple(hTest); /* Add tests as required... */ } #endif int vbsfLock(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint64_t offset, uint64_t length, uint32_t flags) { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); uint32_t fRTLock = 0; int rc; Assert((flags & SHFL_LOCK_MODE_MASK) != SHFL_LOCK_CANCEL); if (pHandle == 0) { AssertFailed(); return VERR_INVALID_HANDLE; } if ( ((flags & SHFL_LOCK_MODE_MASK) == SHFL_LOCK_CANCEL) || (flags & SHFL_LOCK_ENTIRE) ) { AssertFailed(); return VERR_INVALID_PARAMETER; } /* Lock type */ switch(flags & SHFL_LOCK_MODE_MASK) { case SHFL_LOCK_SHARED: fRTLock = RTFILE_LOCK_READ; break; case SHFL_LOCK_EXCLUSIVE: fRTLock = RTFILE_LOCK_READ | RTFILE_LOCK_WRITE; break; default: AssertFailed(); return VERR_INVALID_PARAMETER; } /* Lock wait type */ if (flags & SHFL_LOCK_WAIT) fRTLock |= RTFILE_LOCK_WAIT; else fRTLock |= RTFILE_LOCK_IMMEDIATELY; #ifdef RT_OS_WINDOWS rc = RTFileLock(pHandle->file.Handle, fRTLock, offset, length); if (rc != VINF_SUCCESS) Log(("RTFileLock %RTfile %RX64 %RX64 failed with %Rrc\n", pHandle->file.Handle, offset, length, rc)); #else Log(("vbsfLock: Pretend success handle=%x\n", Handle)); rc = VINF_SUCCESS; #endif return rc; } int vbsfUnlock(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLHANDLE Handle, uint64_t offset, uint64_t length, uint32_t flags) { SHFLFILEHANDLE *pHandle = vbsfQueryFileHandle(pClient, Handle); int rc; Assert((flags & SHFL_LOCK_MODE_MASK) == SHFL_LOCK_CANCEL); if (pHandle == 0) { return VERR_INVALID_HANDLE; } if ( ((flags & SHFL_LOCK_MODE_MASK) != SHFL_LOCK_CANCEL) || (flags & SHFL_LOCK_ENTIRE) ) { return VERR_INVALID_PARAMETER; } #ifdef RT_OS_WINDOWS rc = RTFileUnlock(pHandle->file.Handle, offset, length); if (rc != VINF_SUCCESS) Log(("RTFileUnlock %RTfile %RX64 %RTX64 failed with %Rrc\n", pHandle->file.Handle, offset, length, rc)); #else Log(("vbsfUnlock: Pretend success handle=%x\n", Handle)); rc = VINF_SUCCESS; #endif return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_REMOVE API. Located here as a form of API * documentation. */ void testRemove(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testRemoveBadParameters(hTest); /* Add tests as required... */ } #endif int vbsfRemove(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLSTRING *pPath, uint32_t cbPath, uint32_t flags) { int rc = VINF_SUCCESS; /* Validate input */ if ( flags & ~(SHFL_REMOVE_FILE|SHFL_REMOVE_DIR|SHFL_REMOVE_SYMLINK) || cbPath == 0 || pPath == 0) { AssertFailed(); return VERR_INVALID_PARAMETER; } /* Build a host full path for the given path * and convert ucs2 to utf8 if necessary. */ char *pszFullPath = NULL; rc = vbsfBuildFullPath(pClient, root, pPath, cbPath, &pszFullPath, NULL); if (RT_SUCCESS(rc)) { /* is the guest allowed to write to this share? */ bool fWritable; rc = vbsfMappingsQueryWritable(pClient, root, &fWritable); if (RT_FAILURE(rc) || !fWritable) rc = VERR_WRITE_PROTECT; if (RT_SUCCESS(rc)) { if (flags & SHFL_REMOVE_SYMLINK) rc = RTSymlinkDelete(pszFullPath, 0); else if (flags & SHFL_REMOVE_FILE) rc = RTFileDelete(pszFullPath); else rc = RTDirRemove(pszFullPath); } #ifndef DEBUG_dmik // VERR_ACCESS_DENIED for example? // Assert(rc == VINF_SUCCESS || rc == VERR_DIR_NOT_EMPTY); #endif /* free the path string */ vbsfFreeFullPath(pszFullPath); } return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_RENAME API. Located here as a form of API * documentation. */ void testRename(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testRenameBadParameters(hTest); /* Add tests as required... */ } #endif int vbsfRename(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLSTRING *pSrc, SHFLSTRING *pDest, uint32_t flags) { int rc = VINF_SUCCESS; /* Validate input */ if ( flags & ~(SHFL_REMOVE_FILE|SHFL_REMOVE_DIR|SHFL_RENAME_REPLACE_IF_EXISTS) || pSrc == 0 || pDest == 0) { AssertFailed(); return VERR_INVALID_PARAMETER; } /* Build a host full path for the given path * and convert ucs2 to utf8 if necessary. */ char *pszFullPathSrc = NULL; char *pszFullPathDest = NULL; rc = vbsfBuildFullPath(pClient, root, pSrc, pSrc->u16Size, &pszFullPathSrc, NULL); if (rc != VINF_SUCCESS) return rc; rc = vbsfBuildFullPath(pClient, root, pDest, pDest->u16Size, &pszFullPathDest, NULL, false, true); if (RT_SUCCESS (rc)) { Log(("Rename %s to %s\n", pszFullPathSrc, pszFullPathDest)); /* is the guest allowed to write to this share? */ bool fWritable; rc = vbsfMappingsQueryWritable(pClient, root, &fWritable); if (RT_FAILURE(rc) || !fWritable) rc = VERR_WRITE_PROTECT; if (RT_SUCCESS(rc)) { if (flags & SHFL_RENAME_FILE) { rc = RTFileMove(pszFullPathSrc, pszFullPathDest, ((flags & SHFL_RENAME_REPLACE_IF_EXISTS) ? RTFILEMOVE_FLAGS_REPLACE : 0)); } else { /* NT ignores the REPLACE flag and simply return and already exists error. */ rc = RTDirRename(pszFullPathSrc, pszFullPathDest, ((flags & SHFL_RENAME_REPLACE_IF_EXISTS) ? RTPATHRENAME_FLAGS_REPLACE : 0)); } } #ifndef DEBUG_dmik AssertRC(rc); #endif /* free the path string */ vbsfFreeFullPath(pszFullPathDest); } /* free the path string */ vbsfFreeFullPath(pszFullPathSrc); return rc; } #ifdef UNITTEST /** Unit test the SHFL_FN_SYMLINK API. Located here as a form of API * documentation. */ void testSymlink(RTTEST hTest) { /* If the number or types of parameters are wrong the API should fail. */ testSymlinkBadParameters(hTest); /* Add tests as required... */ } #endif int vbsfSymlink(SHFLCLIENTDATA *pClient, SHFLROOT root, SHFLSTRING *pNewPath, SHFLSTRING *pOldPath, SHFLFSOBJINFO *pInfo) { int rc = VINF_SUCCESS; char *pszFullNewPath = NULL; const char *pszOldPath = (const char *)pOldPath->String.utf8; /* XXX: no support for UCS2 at the moment. */ if (!BIT_FLAG(pClient->fu32Flags, SHFL_CF_UTF8)) return VERR_NOT_IMPLEMENTED; bool fSymlinksCreate; rc = vbsfMappingsQuerySymlinksCreate(pClient, root, &fSymlinksCreate); AssertRCReturn(rc, rc); if (!fSymlinksCreate) return VERR_WRITE_PROTECT; /* XXX or VERR_TOO_MANY_SYMLINKS? */ rc = vbsfBuildFullPath(pClient, root, pNewPath, pNewPath->u16Size, &pszFullNewPath, NULL); AssertRCReturn(rc, rc); rc = RTSymlinkCreate(pszFullNewPath, (const char *)pOldPath->String.utf8, RTSYMLINKTYPE_UNKNOWN, 0); if (RT_SUCCESS(rc)) { RTFSOBJINFO info; rc = RTPathQueryInfoEx(pszFullNewPath, &info, RTFSOBJATTRADD_NOTHING, SHFL_RT_LINK(pClient)); if (RT_SUCCESS(rc)) vbfsCopyFsObjInfoFromIprt(pInfo, &info); } vbsfFreeFullPath(pszFullNewPath); return rc; } /* * Clean up our mess by freeing all handles that are still valid. * */ int vbsfDisconnect(SHFLCLIENTDATA *pClient) { for (int i=0; i