VirtualBox

source: vbox/trunk/src/VBox/HostDrivers/Support/SUPR3HardenedMain.cpp@ 34563

Last change on this file since 34563 was 34448, checked in by vboxsync, 14 years ago

SUPR3HardenedMain: copy/paste bug

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 34.6 KB
Line 
1/* $Id: SUPR3HardenedMain.cpp 34448 2010-11-29 10:35:43Z vboxsync $ */
2/** @file
3 * VirtualBox Support Library - Hardened main().
4 */
5
6/*
7 * Copyright (C) 2006-2010 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 *
17 * The contents of this file may alternatively be used under the terms
18 * of the Common Development and Distribution License Version 1.0
19 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
20 * VirtualBox OSE distribution, in which case the provisions of the
21 * CDDL are applicable instead of those of the GPL.
22 *
23 * You may elect to license modified versions of this file under the
24 * terms and conditions of either the GPL or the CDDL or both.
25 */
26
27/*******************************************************************************
28* Header Files *
29*******************************************************************************/
30#if defined(RT_OS_OS2)
31# define INCL_BASE
32# define INCL_ERRORS
33# include <os2.h>
34# include <stdio.h>
35# include <stdlib.h>
36# include <dlfcn.h>
37
38#elif RT_OS_WINDOWS
39# include <Windows.h>
40# include <stdio.h>
41
42#else /* UNIXes */
43# include <iprt/types.h> /* stdint fun on darwin. */
44
45# include <stdio.h>
46# include <stdlib.h>
47# include <dlfcn.h>
48# include <limits.h>
49# include <errno.h>
50# include <unistd.h>
51# include <sys/stat.h>
52# include <sys/time.h>
53# include <stdio.h>
54# include <sys/types.h>
55# if defined(RT_OS_LINUX)
56# undef USE_LIB_PCAP /* don't depend on libcap as we had to depend on either
57 libcap1 or libcap2 */
58
59# undef _POSIX_SOURCE
60# include <sys/capability.h>
61# include <sys/prctl.h>
62# ifndef CAP_TO_MASK
63# define CAP_TO_MASK(cap) RT_BIT(cap)
64# endif
65# elif defined(RT_OS_FREEBSD)
66# include <sys/param.h>
67# include <sys/sysctl.h>
68# elif defined(RT_OS_SOLARIS)
69# include <priv.h>
70# endif
71# include <pwd.h>
72# ifdef RT_OS_DARWIN
73# include <mach-o/dyld.h>
74# endif
75
76#endif
77
78#include <VBox/sup.h>
79#include <VBox/err.h>
80#include <iprt/string.h>
81#include <iprt/param.h>
82
83#include "SUPLibInternal.h"
84
85
86/*******************************************************************************
87* Defined Constants And Macros *
88*******************************************************************************/
89/** @def SUP_HARDENED_SUID
90 * Whether we're employing set-user-ID-on-execute in the hardening.
91 */
92#if !defined(RT_OS_OS2) && !defined(RT_OS_WINDOWS) && !defined(RT_OS_L4)
93# define SUP_HARDENED_SUID
94#else
95# undef SUP_HARDENED_SUID
96#endif
97
98/** @def SUP_HARDENED_SYM
99 * Decorate a symbol that's resolved dynamically.
100 */
101#ifdef RT_OS_OS2
102# define SUP_HARDENED_SYM(sym) "_" sym
103#else
104# define SUP_HARDENED_SYM(sym) sym
105#endif
106
107
108/*******************************************************************************
109* Structures and Typedefs *
110*******************************************************************************/
111/** @see RTR3InitEx */
112typedef DECLCALLBACK(int) FNRTR3INITEX(uint32_t iVersion, const char *pszProgramPath, bool fInitSUPLib);
113typedef FNRTR3INITEX *PFNRTR3INITEX;
114
115
116/*******************************************************************************
117* Global Variables *
118*******************************************************************************/
119/** The pre-init data we pass on to SUPR3 (residing in VBoxRT). */
120static SUPPREINITDATA g_SupPreInitData;
121/** The program executable path. */
122static char g_szSupLibHardenedExePath[RTPATH_MAX];
123/** The program directory path. */
124static char g_szSupLibHardenedDirPath[RTPATH_MAX];
125
126/** The program name. */
127static const char *g_pszSupLibHardenedProgName;
128
129#ifdef SUP_HARDENED_SUID
130/** The real UID at startup. */
131static uid_t g_uid;
132/** The real GID at startup. */
133static gid_t g_gid;
134# ifdef RT_OS_LINUX
135static uint32_t g_uCaps;
136# endif
137#endif
138
139
140/*******************************************************************************
141* Internal Functions *
142*******************************************************************************/
143#ifdef SUP_HARDENED_SUID
144static void supR3HardenedMainDropPrivileges(void);
145#endif
146static PFNSUPTRUSTEDERROR supR3HardenedMainGetTrustedError(const char *pszProgName);
147
148
149/**
150 * @copydoc RTPathStripFilename.
151 */
152static void suplibHardenedPathStripFilename(char *pszPath)
153{
154 char *psz = pszPath;
155 char *pszLastSep = pszPath;
156
157 for (;; psz++)
158 {
159 switch (*psz)
160 {
161 /* handle separators. */
162#if defined(RT_OS_WINDOWS) || defined(RT_OS_OS2)
163 case ':':
164 pszLastSep = psz + 1;
165 break;
166
167 case '\\':
168#endif
169 case '/':
170 pszLastSep = psz;
171 break;
172
173 /* the end */
174 case '\0':
175 if (pszLastSep == pszPath)
176 *pszLastSep++ = '.';
177 *pszLastSep = '\0';
178 return;
179 }
180 }
181 /* will never get here */
182}
183
184
185/**
186 * @copydoc RTPathFilename
187 */
188DECLHIDDEN(char *) supR3HardenedPathFilename(const char *pszPath)
189{
190 const char *psz = pszPath;
191 const char *pszLastComp = pszPath;
192
193 for (;; psz++)
194 {
195 switch (*psz)
196 {
197 /* handle separators. */
198#if defined(RT_OS_WINDOWS) || defined(RT_OS_OS2)
199 case ':':
200 pszLastComp = psz + 1;
201 break;
202
203 case '\\':
204#endif
205 case '/':
206 pszLastComp = psz + 1;
207 break;
208
209 /* the end */
210 case '\0':
211 if (*pszLastComp)
212 return (char *)(void *)pszLastComp;
213 return NULL;
214 }
215 }
216
217 /* will never get here */
218 return NULL;
219}
220
221
222/**
223 * @copydoc RTPathAppPrivateNoArch
224 */
225DECLHIDDEN(int) supR3HardenedPathAppPrivateNoArch(char *pszPath, size_t cchPath)
226{
227#if !defined(RT_OS_WINDOWS) && defined(RTPATH_APP_PRIVATE)
228 const char *pszSrcPath = RTPATH_APP_PRIVATE;
229 size_t cchPathPrivateNoArch = strlen(pszSrcPath);
230 if (cchPathPrivateNoArch >= cchPath)
231 supR3HardenedFatal("supR3HardenedPathAppPrivateNoArch: Buffer overflow, %lu >= %lu\n",
232 (unsigned long)cchPathPrivateNoArch, (unsigned long)cchPath);
233 memcpy(pszPath, pszSrcPath, cchPathPrivateNoArch + 1);
234 return VINF_SUCCESS;
235
236#else
237 return supR3HardenedPathExecDir(pszPath, cchPath);
238#endif
239}
240
241
242/**
243 * @copydoc RTPathAppPrivateArch
244 */
245DECLHIDDEN(int) supR3HardenedPathAppPrivateArch(char *pszPath, size_t cchPath)
246{
247#if !defined(RT_OS_WINDOWS) && defined(RTPATH_APP_PRIVATE_ARCH)
248 const char *pszSrcPath = RTPATH_APP_PRIVATE_ARCH;
249 size_t cchPathPrivateArch = strlen(pszSrcPath);
250 if (cchPathPrivateArch >= cchPath)
251 supR3HardenedFatal("supR3HardenedPathAppPrivateArch: Buffer overflow, %lu >= %lu\n",
252 (unsigned long)cchPathPrivateArch, (unsigned long)cchPath);
253 memcpy(pszPath, pszSrcPath, cchPathPrivateArch + 1);
254 return VINF_SUCCESS;
255
256#else
257 return supR3HardenedPathExecDir(pszPath, cchPath);
258#endif
259}
260
261
262/**
263 * @copydoc RTPathSharedLibs
264 */
265DECLHIDDEN(int) supR3HardenedPathSharedLibs(char *pszPath, size_t cchPath)
266{
267#if !defined(RT_OS_WINDOWS) && defined(RTPATH_SHARED_LIBS)
268 const char *pszSrcPath = RTPATH_SHARED_LIBS;
269 size_t cchPathSharedLibs = strlen(pszSrcPath);
270 if (cchPathSharedLibs >= cchPath)
271 supR3HardenedFatal("supR3HardenedPathSharedLibs: Buffer overflow, %lu >= %lu\n",
272 (unsigned long)cchPathSharedLibs, (unsigned long)cchPath);
273 memcpy(pszPath, pszSrcPath, cchPathSharedLibs + 1);
274 return VINF_SUCCESS;
275
276#else
277 return supR3HardenedPathExecDir(pszPath, cchPath);
278#endif
279}
280
281
282/**
283 * @copydoc RTPathAppDocs
284 */
285DECLHIDDEN(int) supR3HardenedPathAppDocs(char *pszPath, size_t cchPath)
286{
287#if !defined(RT_OS_WINDOWS) && defined(RTPATH_APP_DOCS)
288 const char *pszSrcPath = RTPATH_APP_DOCS;
289 size_t cchPathAppDocs = strlen(pszSrcPath);
290 if (cchPathAppDocs >= cchPath)
291 supR3HardenedFatal("supR3HardenedPathAppDocs: Buffer overflow, %lu >= %lu\n",
292 (unsigned long)cchPathAppDocs, (unsigned long)cchPath);
293 memcpy(pszPath, pszSrcPath, cchPathAppDocs + 1);
294 return VINF_SUCCESS;
295
296#else
297 return supR3HardenedPathExecDir(pszPath, cchPath);
298#endif
299}
300
301
302/**
303 * Returns the full path to the executable.
304 *
305 * @returns IPRT status code.
306 * @param pszPath Where to store it.
307 * @param cchPath How big that buffer is.
308 */
309static void supR3HardenedGetFullExePath(void)
310{
311 /*
312 * Get the program filename.
313 *
314 * Most UNIXes have no API for obtaining the executable path, but provides a symbolic
315 * link in the proc file system that tells who was exec'ed. The bad thing about this
316 * is that we have to use readlink, one of the weirder UNIX APIs.
317 *
318 * Darwin, OS/2 and Windows all have proper APIs for getting the program file name.
319 */
320#if defined(RT_OS_LINUX) || defined(RT_OS_FREEBSD) || defined(RT_OS_SOLARIS)
321# ifdef RT_OS_LINUX
322 int cchLink = readlink("/proc/self/exe", &g_szSupLibHardenedExePath[0], sizeof(g_szSupLibHardenedExePath) - 1);
323
324# elif defined(RT_OS_SOLARIS)
325 char szFileBuf[PATH_MAX + 1];
326 sprintf(szFileBuf, "/proc/%ld/path/a.out", (long)getpid());
327 int cchLink = readlink(szFileBuf, &g_szSupLibHardenedExePath[0], sizeof(g_szSupLibHardenedExePath) - 1);
328
329# else /* RT_OS_FREEBSD */
330 int aiName[4];
331 aiName[0] = CTL_KERN;
332 aiName[1] = KERN_PROC;
333 aiName[2] = KERN_PROC_PATHNAME;
334 aiName[3] = getpid();
335
336 size_t cbPath = sizeof(g_szSupLibHardenedExePath);
337 if (sysctl(aiName, RT_ELEMENTS(aiName), g_szSupLibHardenedExePath, &cbPath, NULL, 0) < 0)
338 supR3HardenedFatal("supR3HardenedExecDir: sysctl failed\n");
339 g_szSupLibHardenedExePath[sizeof(g_szSupLibHardenedExePath) - 1] = '\0';
340 int cchLink = strlen(g_szSupLibHardenedExePath); /* paranoid? can't we use cbPath? */
341
342# endif
343 if (cchLink < 0 || cchLink == sizeof(g_szSupLibHardenedExePath) - 1)
344 supR3HardenedFatal("supR3HardenedExecDir: couldn't read \"%s\", errno=%d cchLink=%d\n",
345 g_szSupLibHardenedExePath, errno, cchLink);
346 g_szSupLibHardenedExePath[cchLink] = '\0';
347
348#elif defined(RT_OS_OS2) || defined(RT_OS_L4)
349 _execname(g_szSupLibHardenedExePath, sizeof(g_szSupLibHardenedExePath));
350
351#elif defined(RT_OS_DARWIN)
352 const char *pszImageName = _dyld_get_image_name(0);
353 if (!pszImageName)
354 supR3HardenedFatal("supR3HardenedExecDir: _dyld_get_image_name(0) failed\n");
355 size_t cchImageName = strlen(pszImageName);
356 if (!cchImageName || cchImageName >= sizeof(g_szSupLibHardenedExePath))
357 supR3HardenedFatal("supR3HardenedExecDir: _dyld_get_image_name(0) failed, cchImageName=%d\n", cchImageName);
358 memcpy(g_szSupLibHardenedExePath, pszImageName, cchImageName + 1);
359
360#elif defined(RT_OS_WINDOWS)
361 HMODULE hExe = GetModuleHandle(NULL);
362 if (!GetModuleFileName(hExe, &g_szSupLibHardenedExePath[0], sizeof(g_szSupLibHardenedExePath)))
363 supR3HardenedFatal("supR3HardenedExecDir: GetModuleFileName failed, rc=%d\n", GetLastError());
364#else
365# error needs porting.
366#endif
367
368 /*
369 * Strip off the filename part (RTPathStripFilename()).
370 */
371 strcpy(g_szSupLibHardenedDirPath, g_szSupLibHardenedExePath);
372 suplibHardenedPathStripFilename(g_szSupLibHardenedDirPath);
373}
374
375
376#ifdef RT_OS_LINUX
377/**
378 * Checks if we can read /proc/self/exe.
379 *
380 * This is used on linux to see if we have to call init
381 * with program path or not.
382 *
383 * @returns true / false.
384 */
385static bool supR3HardenedMainIsProcSelfExeAccssible(void)
386{
387 char szPath[RTPATH_MAX];
388 int cchLink = readlink("/proc/self/exe", szPath, sizeof(szPath));
389 return cchLink != -1;
390}
391#endif /* RT_OS_LINUX */
392
393
394
395/**
396 * @copydoc RTPathExecDir
397 */
398DECLHIDDEN(int) supR3HardenedPathExecDir(char *pszPath, size_t cchPath)
399{
400 /*
401 * Lazy init (probably not required).
402 */
403 if (!g_szSupLibHardenedDirPath[0])
404 supR3HardenedGetFullExePath();
405
406 /*
407 * Calc the length and check if there is space before copying.
408 */
409 size_t cch = strlen(g_szSupLibHardenedDirPath) + 1;
410 if (cch <= cchPath)
411 {
412 memcpy(pszPath, g_szSupLibHardenedDirPath, cch + 1);
413 return VINF_SUCCESS;
414 }
415
416 supR3HardenedFatal("supR3HardenedPathExecDir: Buffer too small (%u < %u)\n", cchPath, cch);
417 return VERR_BUFFER_OVERFLOW;
418}
419
420
421DECLHIDDEN(void) supR3HardenedFatalMsgV(const char *pszWhere, SUPINITOP enmWhat, int rc, const char *pszMsgFmt, va_list va)
422{
423 /*
424 * To the console first, like supR3HardenedFatalV.
425 */
426 fprintf(stderr, "%s: Error %d in %s!\n", g_pszSupLibHardenedProgName, rc, pszWhere);
427 fprintf(stderr, "%s: ", g_pszSupLibHardenedProgName);
428 va_list vaCopy;
429 va_copy(vaCopy, va);
430 vfprintf(stderr, pszMsgFmt, vaCopy);
431 va_end(vaCopy);
432 fprintf(stderr, "\n");
433
434 switch (enmWhat)
435 {
436 case kSupInitOp_Driver:
437 fprintf(stderr,
438 "\n"
439 "%s: Tip! Make sure the kernel module is loaded. It may also help to reinstall VirtualBox.\n",
440 g_pszSupLibHardenedProgName);
441 break;
442
443 case kSupInitOp_IPRT:
444 case kSupInitOp_Integrity:
445 case kSupInitOp_RootCheck:
446 fprintf(stderr,
447 "\n"
448 "%s: Tip! It may help to reinstall VirtualBox.\n",
449 g_pszSupLibHardenedProgName);
450 break;
451
452 default:
453 /* no hints here */
454 break;
455 }
456
457#ifdef SUP_HARDENED_SUID
458 /*
459 * Drop any root privileges we might be holding, this won't return
460 * if it fails but end up calling supR3HardenedFatal[V].
461 */
462 supR3HardenedMainDropPrivileges();
463#endif /* SUP_HARDENED_SUID */
464
465 /*
466 * Now try resolve and call the TrustedError entry point if we can
467 * find it. We'll fork before we attempt this because that way the
468 * session management in main will see us exiting immediately (if
469 * it's involved with us).
470 */
471#if !defined(RT_OS_WINDOWS) && !defined(RT_OS_OS2)
472 int pid = fork();
473 if (pid <= 0)
474#endif
475 {
476 PFNSUPTRUSTEDERROR pfnTrustedError = supR3HardenedMainGetTrustedError(g_pszSupLibHardenedProgName);
477 if (pfnTrustedError)
478 pfnTrustedError(pszWhere, enmWhat, rc, pszMsgFmt, va);
479 }
480
481 /*
482 * Quit
483 */
484 for (;;)
485#ifdef _MSC_VER
486 exit(1);
487#else
488 _Exit(1);
489#endif
490}
491
492
493DECLHIDDEN(void) supR3HardenedFatalMsg(const char *pszWhere, SUPINITOP enmWhat, int rc, const char *pszMsgFmt, ...)
494{
495 va_list va;
496 va_start(va, pszMsgFmt);
497 supR3HardenedFatalMsgV(pszWhere, enmWhat, rc, pszMsgFmt, va);
498 va_end(va);
499}
500
501
502DECLHIDDEN(void) supR3HardenedFatalV(const char *pszFormat, va_list va)
503{
504 fprintf(stderr, "%s: ", g_pszSupLibHardenedProgName);
505 vfprintf(stderr, pszFormat, va);
506 for (;;)
507#ifdef _MSC_VER
508 exit(1);
509#else
510 _Exit(1);
511#endif
512}
513
514
515DECLHIDDEN(void) supR3HardenedFatal(const char *pszFormat, ...)
516{
517 va_list va;
518 va_start(va, pszFormat);
519 supR3HardenedFatalV(pszFormat, va);
520 va_end(va);
521}
522
523
524DECLHIDDEN(int) supR3HardenedErrorV(int rc, bool fFatal, const char *pszFormat, va_list va)
525{
526 if (fFatal)
527 supR3HardenedFatalV(pszFormat, va);
528
529 fprintf(stderr, "%s: ", g_pszSupLibHardenedProgName);
530 vfprintf(stderr, pszFormat, va);
531 return rc;
532}
533
534
535DECLHIDDEN(int) supR3HardenedError(int rc, bool fFatal, const char *pszFormat, ...)
536{
537 va_list va;
538 va_start(va, pszFormat);
539 supR3HardenedErrorV(rc, fFatal, pszFormat, va);
540 va_end(va);
541 return rc;
542}
543
544
545/**
546 * Wrapper around snprintf which will throw a fatal error on buffer overflow.
547 *
548 * @returns Number of chars in the result string.
549 * @param pszDst The destination buffer.
550 * @param cchDst The size of the buffer.
551 * @param pszFormat The format string.
552 * @param ... Format arguments.
553 */
554static size_t supR3HardenedStrPrintf(char *pszDst, size_t cchDst, const char *pszFormat, ...)
555{
556 va_list va;
557 va_start(va, pszFormat);
558#ifdef _MSC_VER
559 int cch = _vsnprintf(pszDst, cchDst, pszFormat, va);
560#else
561 int cch = vsnprintf(pszDst, cchDst, pszFormat, va);
562#endif
563 va_end(va);
564 if ((unsigned)cch >= cchDst || cch < 0)
565 supR3HardenedFatal("supR3HardenedStrPrintf: buffer overflow, %d >= %lu\n", cch, (long)cchDst);
566 return cch;
567}
568
569
570/**
571 * Attempts to open /dev/vboxdrv (or equvivalent).
572 *
573 * @remarks This function will not return on failure.
574 */
575static void supR3HardenedMainOpenDevice(void)
576{
577 int rc = suplibOsInit(&g_SupPreInitData.Data, false);
578 if (RT_SUCCESS(rc))
579 return;
580
581 switch (rc)
582 {
583 /** @todo better messages! */
584 case VERR_VM_DRIVER_NOT_INSTALLED:
585 supR3HardenedFatalMsg("suplibOsInit", kSupInitOp_Driver, rc,
586 "Kernel driver not installed");
587 case VERR_VM_DRIVER_NOT_ACCESSIBLE:
588 supR3HardenedFatalMsg("suplibOsInit", kSupInitOp_Driver, rc,
589 "Kernel driver not accessible");
590 case VERR_VM_DRIVER_LOAD_ERROR:
591 supR3HardenedFatalMsg("suplibOsInit", kSupInitOp_Driver, rc,
592 "VERR_VM_DRIVER_LOAD_ERROR");
593 case VERR_VM_DRIVER_OPEN_ERROR:
594 supR3HardenedFatalMsg("suplibOsInit", kSupInitOp_Driver, rc,
595 "VERR_VM_DRIVER_OPEN_ERROR");
596 case VERR_VM_DRIVER_VERSION_MISMATCH:
597 supR3HardenedFatalMsg("suplibOsInit", kSupInitOp_Driver, rc,
598 "Kernel driver version mismatch");
599 case VERR_ACCESS_DENIED:
600 supR3HardenedFatalMsg("suplibOsInit", kSupInitOp_Driver, rc,
601 "VERR_ACCESS_DENIED");
602 case VERR_NO_MEMORY:
603 supR3HardenedFatalMsg("suplibOsInit", kSupInitOp_Driver, rc,
604 "Kernel memory allocation/mapping failed");
605 default:
606 supR3HardenedFatalMsg("suplibOsInit", kSupInitOp_Driver, rc,
607 "Unknown rc=%d", rc);
608 }
609}
610
611
612#ifdef SUP_HARDENED_SUID
613
614/**
615 * Grabs extra non-root capabilities / privileges that we might require.
616 *
617 * This is currently only used for being able to do ICMP from the NAT engine.
618 *
619 * @note We still have root privileges at the time of this call.
620 */
621static void supR3HardenedMainGrabCapabilites(void)
622{
623# if defined(RT_OS_LINUX)
624 /*
625 * We are about to drop all our privileges. Remove all capabilities but
626 * keep the cap_net_raw capability for ICMP sockets for the NAT stack.
627 */
628 if (g_uCaps != 0)
629 {
630# ifdef USE_LIB_PCAP
631 /* XXX cap_net_bind_service */
632 if (!cap_set_proc(cap_from_text("all-eip cap_net_raw+ep")))
633 prctl(PR_SET_KEEPCAPS, 1 /*keep=*/, 0, 0, 0);
634 prctl(PR_SET_DUMPABLE, 1 /*dump*/, 0, 0, 0);
635# else
636 cap_user_header_t hdr = (cap_user_header_t)alloca(sizeof(*hdr));
637 cap_user_data_t cap = (cap_user_data_t)alloca(sizeof(*cap));
638 memset(hdr, 0, sizeof(*hdr));
639 hdr->version = _LINUX_CAPABILITY_VERSION;
640 memset(cap, 0, sizeof(*cap));
641 cap->effective = g_uCaps;
642 cap->permitted = g_uCaps;
643 if (!capset(hdr, cap))
644 prctl(PR_SET_KEEPCAPS, 1 /*keep*/, 0, 0, 0);
645 prctl(PR_SET_DUMPABLE, 1 /*dump*/, 0, 0, 0);
646# endif /* !USE_LIB_PCAP */
647 }
648
649# elif defined(RT_OS_SOLARIS)
650 /*
651 * Add net_icmpaccess privilege to permitted and effective privilege set
652 * before dropping root privileges. Leave inheritable privilege set
653 * untouched as we don't want to pass any additional privileges to
654 * subprocesses (think of VBoxSVC).
655 */
656 priv_set_t *pPrivSet = priv_allocset();
657 if (pPrivSet)
658 {
659 priv_emptyset(pPrivSet);
660 /* The inheritable privilege set contains the privileges the process
661 * would have received if it weren't marked as suid root. */
662 int rc = getppriv(PRIV_INHERITABLE, pPrivSet);
663 if (!rc)
664 {
665 priv_addset(pPrivSet, PRIV_NET_ICMPACCESS);
666 rc = setppriv(PRIV_SET, PRIV_PERMITTED, pPrivSet);
667 if (!rc)
668 {
669 rc = setppriv(PRIV_SET, PRIV_EFFECTIVE, pPrivSet);
670 if (rc)
671 supR3HardenedError(rc, false, "SUPR3HardenedMain: failed to set effective privilege set.\n");
672 }
673 else
674 supR3HardenedError(rc, false, "SUPR3HardenedMain: failed to set permitted privilege set.\n");
675 }
676 else
677 supR3HardenedError(rc, false, "SUPR3HardenedMain: failed to get inheritable privilege set.\n");
678
679 priv_freeset(pPrivSet);
680 }
681 else
682 supR3HardenedError(-1, false, "SUPR3HardenedMain: failed to allocate privilege set.\n");
683# endif
684}
685
686/*
687 * Look at the environment for some special options.
688 */
689static void supR3GrabOptions(void)
690{
691 const char *pszOpt;
692
693# ifdef RT_OS_LINUX
694 g_uCaps = 0;
695
696 /*
697 * Do _not_ perform any capability-related system calls for root processes
698 * (leaving g_uCaps at 0).
699 * (Hint: getuid gets the real user id, not the effective.)
700 */
701 if (getuid() != 0)
702 {
703 /*
704 * CAP_NET_RAW.
705 * Default: enabled.
706 * Can be disabled with 'export VBOX_HARD_CAP_NET_RAW=0'.
707 */
708 pszOpt = getenv("VBOX_HARD_CAP_NET_RAW");
709 if ( !pszOpt
710 || memcmp(pszOpt, "0", sizeof("0")) != 0)
711 g_uCaps = CAP_TO_MASK(CAP_NET_RAW);
712
713 /*
714 * CAP_NET_BIND_SERVICE.
715 * Default: disabled.
716 * Can be enabled with 'export VBOX_HARD_CAP_NET_BIND_SERVICE=1'.
717 */
718 pszOpt = getenv("VBOX_HARD_CAP_NET_BIND_SERVICE");
719 if ( pszOpt
720 && memcmp(pszOpt, "0", sizeof("0")) != 0)
721 g_uCaps |= CAP_TO_MASK(CAP_NET_BIND_SERVICE);
722 }
723# endif
724}
725
726/**
727 * Drop any root privileges we might be holding.
728 */
729static void supR3HardenedMainDropPrivileges(void)
730{
731 /*
732 * Try use setre[ug]id since this will clear the save uid/gid and thus
733 * leave fewer traces behind that libs like GTK+ may pick up.
734 */
735 uid_t euid, ruid, suid;
736 gid_t egid, rgid, sgid;
737# if defined(RT_OS_DARWIN)
738 /* The really great thing here is that setreuid isn't available on
739 OS X 10.4, libc emulates it. While 10.4 have a slightly different and
740 non-standard setuid implementation compared to 10.5, the following
741 works the same way with both version since we're super user (10.5 req).
742 The following will set all three variants of the group and user IDs. */
743 setgid(g_gid);
744 setuid(g_uid);
745 euid = geteuid();
746 ruid = suid = getuid();
747 egid = getegid();
748 rgid = sgid = getgid();
749
750# elif defined(RT_OS_SOLARIS)
751 /* Solaris doesn't have setresuid, but the setreuid interface is BSD
752 compatible and will set the saved uid to euid when we pass it a ruid
753 that isn't -1 (which we do). */
754 setregid(g_gid, g_gid);
755 setreuid(g_uid, g_uid);
756 euid = geteuid();
757 ruid = suid = getuid();
758 egid = getegid();
759 rgid = sgid = getgid();
760
761# else
762 /* This is the preferred one, full control no questions about semantics.
763 PORTME: If this isn't work, try join one of two other gangs above. */
764 setresgid(g_gid, g_gid, g_gid);
765 setresuid(g_uid, g_uid, g_uid);
766 if (getresuid(&ruid, &euid, &suid) != 0)
767 {
768 euid = geteuid();
769 ruid = suid = getuid();
770 }
771 if (getresgid(&rgid, &egid, &sgid) != 0)
772 {
773 egid = getegid();
774 rgid = sgid = getgid();
775 }
776# endif
777
778
779 /* Check that it worked out all right. */
780 if ( euid != g_uid
781 || ruid != g_uid
782 || suid != g_uid
783 || egid != g_gid
784 || rgid != g_gid
785 || sgid != g_gid)
786 supR3HardenedFatal("SUPR3HardenedMain: failed to drop root privileges!"
787 " (euid=%d ruid=%d suid=%d egid=%d rgid=%d sgid=%d; wanted uid=%d and gid=%d)\n",
788 euid, ruid, suid, egid, rgid, sgid, g_uid, g_gid);
789
790# if RT_OS_LINUX
791 /*
792 * Re-enable the cap_net_raw capability which was disabled during setresuid.
793 */
794 if (g_uCaps != 0)
795 {
796# ifdef USE_LIB_PCAP
797 /** @todo Warn if that does not work? */
798 /* XXX cap_net_bind_service */
799 cap_set_proc(cap_from_text("cap_net_raw+ep"));
800# else
801 cap_user_header_t hdr = (cap_user_header_t)alloca(sizeof(*hdr));
802 cap_user_data_t cap = (cap_user_data_t)alloca(sizeof(*cap));
803 memset(hdr, 0, sizeof(*hdr));
804 hdr->version = _LINUX_CAPABILITY_VERSION;
805 memset(cap, 0, sizeof(*cap));
806 cap->effective = g_uCaps;
807 cap->permitted = g_uCaps;
808 /** @todo Warn if that does not work? */
809 capset(hdr, cap);
810# endif /* !USE_LIB_PCAP */
811 }
812# endif
813}
814
815#endif /* SUP_HARDENED_SUID */
816
817/**
818 * Loads the VBoxRT DLL/SO/DYLIB, hands it the open driver,
819 * and calls RTR3Init.
820 *
821 * @param fFlags The SUPR3HardenedMain fFlags argument, passed to supR3PreInit.
822 *
823 * @remarks VBoxRT contains both IPRT and SUPR3.
824 * @remarks This function will not return on failure.
825 */
826static void supR3HardenedMainInitRuntime(uint32_t fFlags)
827{
828 /*
829 * Construct the name.
830 */
831 char szPath[RTPATH_MAX];
832 supR3HardenedPathSharedLibs(szPath, sizeof(szPath) - sizeof("/VBoxRT" SUPLIB_DLL_SUFF));
833 strcat(szPath, "/VBoxRT" SUPLIB_DLL_SUFF);
834
835 /*
836 * Open it and resolve the symbols.
837 */
838#if defined(RT_OS_WINDOWS)
839 /** @todo consider using LOAD_WITH_ALTERED_SEARCH_PATH here! */
840 HMODULE hMod = LoadLibraryEx(szPath, NULL /*hFile*/, 0 /* dwFlags */);
841 if (!hMod)
842 supR3HardenedFatalMsg("supR3HardenedMainInitRuntime", kSupInitOp_IPRT, VERR_MODULE_NOT_FOUND,
843 "LoadLibraryEx(\"%s\",,) failed (rc=%d)",
844 szPath, GetLastError());
845 PFNRTR3INITEX pfnRTInitEx = (PFNRTR3INITEX)GetProcAddress(hMod, SUP_HARDENED_SYM("RTR3InitEx"));
846 if (!pfnRTInitEx)
847 supR3HardenedFatalMsg("supR3HardenedMainInitRuntime", kSupInitOp_IPRT, VERR_SYMBOL_NOT_FOUND,
848 "Entrypoint \"RTR3InitEx\" not found in \"%s\" (rc=%d)",
849 szPath, GetLastError());
850
851 PFNSUPR3PREINIT pfnSUPPreInit = (PFNSUPR3PREINIT)GetProcAddress(hMod, SUP_HARDENED_SYM("supR3PreInit"));
852 if (!pfnSUPPreInit)
853 supR3HardenedFatalMsg("supR3HardenedMainInitRuntime", kSupInitOp_IPRT, VERR_SYMBOL_NOT_FOUND,
854 "Entrypoint \"supR3PreInit\" not found in \"%s\" (rc=%d)",
855 szPath, GetLastError());
856
857#else
858 /* the dlopen crowd */
859 void *pvMod = dlopen(szPath, RTLD_NOW | RTLD_GLOBAL);
860 if (!pvMod)
861 supR3HardenedFatalMsg("supR3HardenedMainInitRuntime", kSupInitOp_IPRT, VERR_MODULE_NOT_FOUND,
862 "dlopen(\"%s\",) failed: %s",
863 szPath, dlerror());
864 PFNRTR3INITEX pfnRTInitEx = (PFNRTR3INITEX)(uintptr_t)dlsym(pvMod, SUP_HARDENED_SYM("RTR3InitEx"));
865 if (!pfnRTInitEx)
866 supR3HardenedFatalMsg("supR3HardenedMainInitRuntime", kSupInitOp_IPRT, VERR_SYMBOL_NOT_FOUND,
867 "Entrypoint \"RTR3InitEx\" not found in \"%s\"!\ndlerror: %s",
868 szPath, dlerror());
869 PFNSUPR3PREINIT pfnSUPPreInit = (PFNSUPR3PREINIT)(uintptr_t)dlsym(pvMod, SUP_HARDENED_SYM("supR3PreInit"));
870 if (!pfnSUPPreInit)
871 supR3HardenedFatalMsg("supR3HardenedMainInitRuntime", kSupInitOp_IPRT, VERR_SYMBOL_NOT_FOUND,
872 "Entrypoint \"supR3PreInit\" not found in \"%s\"!\ndlerror: %s",
873 szPath, dlerror());
874#endif
875
876 /*
877 * Make the calls.
878 */
879 supR3HardenedGetPreInitData(&g_SupPreInitData);
880 int rc = pfnSUPPreInit(&g_SupPreInitData, fFlags);
881 if (RT_FAILURE(rc))
882 supR3HardenedFatalMsg("supR3HardenedMainInitRuntime", kSupInitOp_IPRT, rc,
883 "supR3PreInit failed with rc=%d", rc);
884 const char *pszExePath = NULL;
885#ifdef RT_OS_LINUX
886 if (!supR3HardenedMainIsProcSelfExeAccssible())
887 pszExePath = g_szSupLibHardenedExePath;
888#endif
889 rc = pfnRTInitEx(0, pszExePath, !(fFlags & SUPSECMAIN_FLAGS_DONT_OPEN_DEV));
890 if (RT_FAILURE(rc))
891 supR3HardenedFatalMsg("supR3HardenedMainInitRuntime", kSupInitOp_IPRT, rc,
892 "RTR3Init failed with rc=%d", rc);
893}
894
895
896/**
897 * Loads the DLL/SO/DYLIB containing the actual program and
898 * resolves the TrustedError symbol.
899 *
900 * This is very similar to supR3HardenedMainGetTrustedMain().
901 *
902 * @returns Pointer to the trusted error symbol if it is exported, NULL
903 * and no error messages otherwise.
904 * @param pszProgName The program name.
905 */
906static PFNSUPTRUSTEDERROR supR3HardenedMainGetTrustedError(const char *pszProgName)
907{
908 /*
909 * Construct the name.
910 */
911 char szPath[RTPATH_MAX];
912 supR3HardenedPathAppPrivateArch(szPath, sizeof(szPath) - 10);
913 size_t cch = strlen(szPath);
914 supR3HardenedStrPrintf(&szPath[cch], sizeof(szPath) - cch, "/%s%s", pszProgName, SUPLIB_DLL_SUFF);
915
916 /*
917 * Open it and resolve the symbol.
918 */
919#if defined(RT_OS_WINDOWS)
920 /** @todo consider using LOAD_WITH_ALTERED_SEARCH_PATH here! */
921 HMODULE hMod = LoadLibraryEx(szPath, NULL /*hFile*/, 0 /* dwFlags */);
922 if (!hMod)
923 return NULL;
924 FARPROC pfn = GetProcAddress(hMod, SUP_HARDENED_SYM("TrustedError"));
925 if (!pfn)
926 return NULL;
927 return (PFNSUPTRUSTEDERROR)pfn;
928
929#else
930 /* the dlopen crowd */
931 void *pvMod = dlopen(szPath, RTLD_NOW | RTLD_GLOBAL);
932 if (!pvMod)
933 return NULL;
934 void *pvSym = dlsym(pvMod, SUP_HARDENED_SYM("TrustedError"));
935 if (!pvSym)
936 return NULL;
937 return (PFNSUPTRUSTEDERROR)(uintptr_t)pvSym;
938#endif
939}
940
941
942/**
943 * Loads the DLL/SO/DYLIB containing the actual program and
944 * resolves the TrustedMain symbol.
945 *
946 * @returns Pointer to the trusted main of the actual program.
947 * @param pszProgName The program name.
948 * @remarks This function will not return on failure.
949 */
950static PFNSUPTRUSTEDMAIN supR3HardenedMainGetTrustedMain(const char *pszProgName)
951{
952 /*
953 * Construct the name.
954 */
955 char szPath[RTPATH_MAX];
956 supR3HardenedPathAppPrivateArch(szPath, sizeof(szPath) - 10);
957 size_t cch = strlen(szPath);
958 supR3HardenedStrPrintf(&szPath[cch], sizeof(szPath) - cch, "/%s%s", pszProgName, SUPLIB_DLL_SUFF);
959
960 /*
961 * Open it and resolve the symbol.
962 */
963#if defined(RT_OS_WINDOWS)
964 /** @todo consider using LOAD_WITH_ALTERED_SEARCH_PATH here! */
965 HMODULE hMod = LoadLibraryEx(szPath, NULL /*hFile*/, 0 /* dwFlags */);
966 if (!hMod)
967 supR3HardenedFatal("supR3HardenedMainGetTrustedMain: LoadLibraryEx(\"%s\",,) failed, rc=%d\n",
968 szPath, GetLastError());
969 FARPROC pfn = GetProcAddress(hMod, SUP_HARDENED_SYM("TrustedMain"));
970 if (!pfn)
971 supR3HardenedFatal("supR3HardenedMainGetTrustedMain: Entrypoint \"TrustedMain\" not found in \"%s\" (rc=%d)\n",
972 szPath, GetLastError());
973 return (PFNSUPTRUSTEDMAIN)pfn;
974
975#else
976 /* the dlopen crowd */
977 void *pvMod = dlopen(szPath, RTLD_NOW | RTLD_GLOBAL);
978 if (!pvMod)
979 supR3HardenedFatal("supR3HardenedMainGetTrustedMain: dlopen(\"%s\",) failed: %s\n",
980 szPath, dlerror());
981 void *pvSym = dlsym(pvMod, SUP_HARDENED_SYM("TrustedMain"));
982 if (!pvSym)
983 supR3HardenedFatal("supR3HardenedMainGetTrustedMain: Entrypoint \"TrustedMain\" not found in \"%s\"!\ndlerror: %s\n",
984 szPath, dlerror());
985 return (PFNSUPTRUSTEDMAIN)(uintptr_t)pvSym;
986#endif
987}
988
989
990/**
991 * Secure main.
992 *
993 * This is used for the set-user-ID-on-execute binaries on unixy systems
994 * and when using the open-vboxdrv-via-root-service setup on Windows.
995 *
996 * This function will perform the integrity checks of the VirtualBox
997 * installation, open the support driver, open the root service (later),
998 * and load the DLL corresponding to \a pszProgName and execute its main
999 * function.
1000 *
1001 * @returns Return code appropriate for main().
1002 *
1003 * @param pszProgName The program name. This will be used to figure out which
1004 * DLL/SO/DYLIB to load and execute.
1005 * @param fFlags Flags.
1006 * @param argc The argument count.
1007 * @param argv The argument vector.
1008 * @param envp The environment vector.
1009 */
1010DECLHIDDEN(int) SUPR3HardenedMain(const char *pszProgName, uint32_t fFlags, int argc, char **argv, char **envp)
1011{
1012 /*
1013 * Note! At this point there is no IPRT, so we will have to stick
1014 * to basic CRT functions that everyone agree upon.
1015 */
1016 g_pszSupLibHardenedProgName = pszProgName;
1017 g_SupPreInitData.u32Magic = SUPPREINITDATA_MAGIC;
1018 g_SupPreInitData.Data.hDevice = NIL_RTFILE;
1019 g_SupPreInitData.u32EndMagic = SUPPREINITDATA_MAGIC;
1020
1021#ifdef SUP_HARDENED_SUID
1022# ifdef RT_OS_LINUX
1023 /*
1024 * On linux we have to make sure the path is initialized because we
1025 * *might* not be able to access /proc/self/exe after the seteuid call.
1026 */
1027 supR3HardenedGetFullExePath();
1028
1029# endif
1030
1031 /*
1032 * Grab any options from the environment.
1033 */
1034 supR3GrabOptions();
1035
1036 /*
1037 * Check that we're root, if we aren't then the installation is butchered.
1038 */
1039 g_uid = getuid();
1040 g_gid = getgid();
1041 if (geteuid() != 0 /* root */)
1042 supR3HardenedFatalMsg("SUPR3HardenedMain", kSupInitOp_RootCheck, VERR_PERMISSION_DENIED,
1043 "Effective UID is not root (euid=%d egid=%d uid=%d gid=%d)",
1044 geteuid(), getegid(), g_uid, g_gid);
1045#endif
1046
1047 /*
1048 * Validate the installation.
1049 */
1050 supR3HardenedVerifyAll(true /* fFatal */, false /* fLeaveFilesOpen */, pszProgName);
1051
1052 /*
1053 * Open the vboxdrv device.
1054 */
1055 if (!(fFlags & SUPSECMAIN_FLAGS_DONT_OPEN_DEV))
1056 supR3HardenedMainOpenDevice();
1057
1058 /*
1059 * Open the root service connection.
1060 */
1061 //if (!(fFlags & SUPSECMAIN_FLAGS_DONT_OPEN_SVC))
1062 //supR3HardenedMainOpenService(&g_SupPreInitData, true /* fFatal */);
1063
1064#ifdef SUP_HARDENED_SUID
1065 /*
1066 * Grab additional capabilities / privileges.
1067 */
1068 supR3HardenedMainGrabCapabilites();
1069
1070 /*
1071 * Drop any root privileges we might be holding (won't return on failure)
1072 */
1073 supR3HardenedMainDropPrivileges();
1074#endif
1075
1076 /*
1077 * Load the IPRT, hand the SUPLib part the open driver and
1078 * call RTR3Init.
1079 */
1080 supR3HardenedMainInitRuntime(fFlags);
1081
1082 /*
1083 * Load the DLL/SO/DYLIB containing the actual program
1084 * and pass control to it.
1085 */
1086 PFNSUPTRUSTEDMAIN pfnTrustedMain = supR3HardenedMainGetTrustedMain(pszProgName);
1087 return pfnTrustedMain(argc, argv, envp);
1088}
1089
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette