src/os/solaris/vm/perfMemory_solaris.cpp

Fri, 27 Feb 2009 13:27:09 -0800

author
twisti
date
Fri, 27 Feb 2009 13:27:09 -0800
changeset 1040
98cb887364d3
parent 435
a61af66fc99e
child 1788
a2ea687fdc7c
permissions
-rw-r--r--

6810672: Comment typos
Summary: I have collected some typos I have found while looking at the code.
Reviewed-by: kvn, never

duke@435 1 /*
duke@435 2 * Copyright 2001-2007 Sun Microsystems, Inc. All Rights Reserved.
duke@435 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@435 4 *
duke@435 5 * This code is free software; you can redistribute it and/or modify it
duke@435 6 * under the terms of the GNU General Public License version 2 only, as
duke@435 7 * published by the Free Software Foundation.
duke@435 8 *
duke@435 9 * This code is distributed in the hope that it will be useful, but WITHOUT
duke@435 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@435 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@435 12 * version 2 for more details (a copy is included in the LICENSE file that
duke@435 13 * accompanied this code).
duke@435 14 *
duke@435 15 * You should have received a copy of the GNU General Public License version
duke@435 16 * 2 along with this work; if not, write to the Free Software Foundation,
duke@435 17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@435 18 *
duke@435 19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
duke@435 20 * CA 95054 USA or visit www.sun.com if you need additional information or
duke@435 21 * have any questions.
duke@435 22 *
duke@435 23 */
duke@435 24
duke@435 25 # include "incls/_precompiled.incl"
duke@435 26 # include "incls/_perfMemory_solaris.cpp.incl"
duke@435 27
duke@435 28 // put OS-includes here
duke@435 29 # include <sys/types.h>
duke@435 30 # include <sys/mman.h>
duke@435 31 # include <errno.h>
duke@435 32 # include <stdio.h>
duke@435 33 # include <unistd.h>
duke@435 34 # include <sys/stat.h>
duke@435 35 # include <signal.h>
duke@435 36 # include <pwd.h>
duke@435 37 # include <procfs.h>
duke@435 38
duke@435 39
duke@435 40 static char* backing_store_file_name = NULL; // name of the backing store
duke@435 41 // file, if successfully created.
duke@435 42
duke@435 43 // Standard Memory Implementation Details
duke@435 44
duke@435 45 // create the PerfData memory region in standard memory.
duke@435 46 //
duke@435 47 static char* create_standard_memory(size_t size) {
duke@435 48
duke@435 49 // allocate an aligned chuck of memory
duke@435 50 char* mapAddress = os::reserve_memory(size);
duke@435 51
duke@435 52 if (mapAddress == NULL) {
duke@435 53 return NULL;
duke@435 54 }
duke@435 55
duke@435 56 // commit memory
duke@435 57 if (!os::commit_memory(mapAddress, size)) {
duke@435 58 if (PrintMiscellaneous && Verbose) {
duke@435 59 warning("Could not commit PerfData memory\n");
duke@435 60 }
duke@435 61 os::release_memory(mapAddress, size);
duke@435 62 return NULL;
duke@435 63 }
duke@435 64
duke@435 65 return mapAddress;
duke@435 66 }
duke@435 67
duke@435 68 // delete the PerfData memory region
duke@435 69 //
duke@435 70 static void delete_standard_memory(char* addr, size_t size) {
duke@435 71
duke@435 72 // there are no persistent external resources to cleanup for standard
duke@435 73 // memory. since DestroyJavaVM does not support unloading of the JVM,
duke@435 74 // cleanup of the memory resource is not performed. The memory will be
duke@435 75 // reclaimed by the OS upon termination of the process.
duke@435 76 //
duke@435 77 return;
duke@435 78 }
duke@435 79
duke@435 80 // save the specified memory region to the given file
duke@435 81 //
duke@435 82 // Note: this function might be called from signal handler (by os::abort()),
duke@435 83 // don't allocate heap memory.
duke@435 84 //
duke@435 85 static void save_memory_to_file(char* addr, size_t size) {
duke@435 86
duke@435 87 const char* destfile = PerfMemory::get_perfdata_file_path();
duke@435 88 assert(destfile[0] != '\0', "invalid PerfData file path");
duke@435 89
duke@435 90 int result;
duke@435 91
duke@435 92 RESTARTABLE(::open(destfile, O_CREAT|O_WRONLY|O_TRUNC, S_IREAD|S_IWRITE),
duke@435 93 result);;
duke@435 94 if (result == OS_ERR) {
duke@435 95 if (PrintMiscellaneous && Verbose) {
duke@435 96 warning("Could not create Perfdata save file: %s: %s\n",
duke@435 97 destfile, strerror(errno));
duke@435 98 }
duke@435 99 } else {
duke@435 100
duke@435 101 int fd = result;
duke@435 102
duke@435 103 for (size_t remaining = size; remaining > 0;) {
duke@435 104
duke@435 105 RESTARTABLE(::write(fd, addr, remaining), result);
duke@435 106 if (result == OS_ERR) {
duke@435 107 if (PrintMiscellaneous && Verbose) {
duke@435 108 warning("Could not write Perfdata save file: %s: %s\n",
duke@435 109 destfile, strerror(errno));
duke@435 110 }
duke@435 111 break;
duke@435 112 }
duke@435 113 remaining -= (size_t)result;
duke@435 114 addr += result;
duke@435 115 }
duke@435 116
duke@435 117 RESTARTABLE(::close(fd), result);
duke@435 118 if (PrintMiscellaneous && Verbose) {
duke@435 119 if (result == OS_ERR) {
duke@435 120 warning("Could not close %s: %s\n", destfile, strerror(errno));
duke@435 121 }
duke@435 122 }
duke@435 123 }
duke@435 124 FREE_C_HEAP_ARRAY(char, destfile);
duke@435 125 }
duke@435 126
duke@435 127
duke@435 128 // Shared Memory Implementation Details
duke@435 129
duke@435 130 // Note: the solaris and linux shared memory implementation uses the mmap
duke@435 131 // interface with a backing store file to implement named shared memory.
duke@435 132 // Using the file system as the name space for shared memory allows a
duke@435 133 // common name space to be supported across a variety of platforms. It
duke@435 134 // also provides a name space that Java applications can deal with through
duke@435 135 // simple file apis.
duke@435 136 //
duke@435 137 // The solaris and linux implementations store the backing store file in
duke@435 138 // a user specific temporary directory located in the /tmp file system,
duke@435 139 // which is always a local file system and is sometimes a RAM based file
duke@435 140 // system.
duke@435 141
duke@435 142 // return the user specific temporary directory name.
duke@435 143 //
duke@435 144 // the caller is expected to free the allocated memory.
duke@435 145 //
duke@435 146 static char* get_user_tmp_dir(const char* user) {
duke@435 147
duke@435 148 const char* tmpdir = os::get_temp_directory();
duke@435 149 const char* perfdir = PERFDATA_NAME;
duke@435 150 size_t nbytes = strlen(tmpdir) + strlen(perfdir) + strlen(user) + 2;
duke@435 151 char* dirname = NEW_C_HEAP_ARRAY(char, nbytes);
duke@435 152
duke@435 153 // construct the path name to user specific tmp directory
duke@435 154 snprintf(dirname, nbytes, "%s%s_%s", tmpdir, perfdir, user);
duke@435 155
duke@435 156 return dirname;
duke@435 157 }
duke@435 158
duke@435 159 // convert the given file name into a process id. if the file
duke@435 160 // does not meet the file naming constraints, return 0.
duke@435 161 //
duke@435 162 static pid_t filename_to_pid(const char* filename) {
duke@435 163
duke@435 164 // a filename that doesn't begin with a digit is not a
duke@435 165 // candidate for conversion.
duke@435 166 //
duke@435 167 if (!isdigit(*filename)) {
duke@435 168 return 0;
duke@435 169 }
duke@435 170
duke@435 171 // check if file name can be converted to an integer without
duke@435 172 // any leftover characters.
duke@435 173 //
duke@435 174 char* remainder = NULL;
duke@435 175 errno = 0;
duke@435 176 pid_t pid = (pid_t)strtol(filename, &remainder, 10);
duke@435 177
duke@435 178 if (errno != 0) {
duke@435 179 return 0;
duke@435 180 }
duke@435 181
duke@435 182 // check for left over characters. If any, then the filename is
duke@435 183 // not a candidate for conversion.
duke@435 184 //
duke@435 185 if (remainder != NULL && *remainder != '\0') {
duke@435 186 return 0;
duke@435 187 }
duke@435 188
duke@435 189 // successful conversion, return the pid
duke@435 190 return pid;
duke@435 191 }
duke@435 192
duke@435 193
duke@435 194 // check if the given path is considered a secure directory for
duke@435 195 // the backing store files. Returns true if the directory exists
duke@435 196 // and is considered a secure location. Returns false if the path
twisti@1040 197 // is a symbolic link or if an error occurred.
duke@435 198 //
duke@435 199 static bool is_directory_secure(const char* path) {
duke@435 200 struct stat statbuf;
duke@435 201 int result = 0;
duke@435 202
duke@435 203 RESTARTABLE(::lstat(path, &statbuf), result);
duke@435 204 if (result == OS_ERR) {
duke@435 205 return false;
duke@435 206 }
duke@435 207
duke@435 208 // the path exists, now check it's mode
duke@435 209 if (S_ISLNK(statbuf.st_mode) || !S_ISDIR(statbuf.st_mode)) {
duke@435 210 // the path represents a link or some non-directory file type,
duke@435 211 // which is not what we expected. declare it insecure.
duke@435 212 //
duke@435 213 return false;
duke@435 214 }
duke@435 215 else {
duke@435 216 // we have an existing directory, check if the permissions are safe.
duke@435 217 //
duke@435 218 if ((statbuf.st_mode & (S_IWGRP|S_IWOTH)) != 0) {
duke@435 219 // the directory is open for writing and could be subjected
duke@435 220 // to a symlnk attack. declare it insecure.
duke@435 221 //
duke@435 222 return false;
duke@435 223 }
duke@435 224 }
duke@435 225 return true;
duke@435 226 }
duke@435 227
duke@435 228
duke@435 229 // return the user name for the given user id
duke@435 230 //
duke@435 231 // the caller is expected to free the allocated memory.
duke@435 232 //
duke@435 233 static char* get_user_name(uid_t uid) {
duke@435 234
duke@435 235 struct passwd pwent;
duke@435 236
duke@435 237 // determine the max pwbuf size from sysconf, and hardcode
duke@435 238 // a default if this not available through sysconf.
duke@435 239 //
duke@435 240 long bufsize = sysconf(_SC_GETPW_R_SIZE_MAX);
duke@435 241 if (bufsize == -1)
duke@435 242 bufsize = 1024;
duke@435 243
duke@435 244 char* pwbuf = NEW_C_HEAP_ARRAY(char, bufsize);
duke@435 245
duke@435 246 #ifdef _GNU_SOURCE
duke@435 247 struct passwd* p = NULL;
duke@435 248 int result = getpwuid_r(uid, &pwent, pwbuf, (size_t)bufsize, &p);
duke@435 249 #else // _GNU_SOURCE
duke@435 250 struct passwd* p = getpwuid_r(uid, &pwent, pwbuf, (int)bufsize);
duke@435 251 #endif // _GNU_SOURCE
duke@435 252
duke@435 253 if (p == NULL || p->pw_name == NULL || *(p->pw_name) == '\0') {
duke@435 254 if (PrintMiscellaneous && Verbose) {
duke@435 255 if (p == NULL) {
duke@435 256 warning("Could not retrieve passwd entry: %s\n",
duke@435 257 strerror(errno));
duke@435 258 }
duke@435 259 else {
duke@435 260 warning("Could not determine user name: %s\n",
duke@435 261 p->pw_name == NULL ? "pw_name = NULL" :
duke@435 262 "pw_name zero length");
duke@435 263 }
duke@435 264 }
duke@435 265 FREE_C_HEAP_ARRAY(char, pwbuf);
duke@435 266 return NULL;
duke@435 267 }
duke@435 268
duke@435 269 char* user_name = NEW_C_HEAP_ARRAY(char, strlen(p->pw_name) + 1);
duke@435 270 strcpy(user_name, p->pw_name);
duke@435 271
duke@435 272 FREE_C_HEAP_ARRAY(char, pwbuf);
duke@435 273 return user_name;
duke@435 274 }
duke@435 275
duke@435 276 // return the name of the user that owns the process identified by vmid.
duke@435 277 //
duke@435 278 // This method uses a slow directory search algorithm to find the backing
duke@435 279 // store file for the specified vmid and returns the user name, as determined
duke@435 280 // by the user name suffix of the hsperfdata_<username> directory name.
duke@435 281 //
duke@435 282 // the caller is expected to free the allocated memory.
duke@435 283 //
duke@435 284 static char* get_user_name_slow(int vmid, TRAPS) {
duke@435 285
duke@435 286 // short circuit the directory search if the process doesn't even exist.
duke@435 287 if (kill(vmid, 0) == OS_ERR) {
duke@435 288 if (errno == ESRCH) {
duke@435 289 THROW_MSG_0(vmSymbols::java_lang_IllegalArgumentException(),
duke@435 290 "Process not found");
duke@435 291 }
duke@435 292 else /* EPERM */ {
duke@435 293 THROW_MSG_0(vmSymbols::java_io_IOException(), strerror(errno));
duke@435 294 }
duke@435 295 }
duke@435 296
duke@435 297 // directory search
duke@435 298 char* oldest_user = NULL;
duke@435 299 time_t oldest_ctime = 0;
duke@435 300
duke@435 301 const char* tmpdirname = os::get_temp_directory();
duke@435 302
duke@435 303 DIR* tmpdirp = os::opendir(tmpdirname);
duke@435 304
duke@435 305 if (tmpdirp == NULL) {
duke@435 306 return NULL;
duke@435 307 }
duke@435 308
duke@435 309 // for each entry in the directory that matches the pattern hsperfdata_*,
duke@435 310 // open the directory and check if the file for the given vmid exists.
duke@435 311 // The file with the expected name and the latest creation date is used
duke@435 312 // to determine the user name for the process id.
duke@435 313 //
duke@435 314 struct dirent* dentry;
duke@435 315 char* tdbuf = NEW_C_HEAP_ARRAY(char, os::readdir_buf_size(tmpdirname));
duke@435 316 errno = 0;
duke@435 317 while ((dentry = os::readdir(tmpdirp, (struct dirent *)tdbuf)) != NULL) {
duke@435 318
duke@435 319 // check if the directory entry is a hsperfdata file
duke@435 320 if (strncmp(dentry->d_name, PERFDATA_NAME, strlen(PERFDATA_NAME)) != 0) {
duke@435 321 continue;
duke@435 322 }
duke@435 323
duke@435 324 char* usrdir_name = NEW_C_HEAP_ARRAY(char,
duke@435 325 strlen(tmpdirname) + strlen(dentry->d_name) + 1);
duke@435 326 strcpy(usrdir_name, tmpdirname);
duke@435 327 strcat(usrdir_name, dentry->d_name);
duke@435 328
duke@435 329 DIR* subdirp = os::opendir(usrdir_name);
duke@435 330
duke@435 331 if (subdirp == NULL) {
duke@435 332 FREE_C_HEAP_ARRAY(char, usrdir_name);
duke@435 333 continue;
duke@435 334 }
duke@435 335
duke@435 336 // Since we don't create the backing store files in directories
duke@435 337 // pointed to by symbolic links, we also don't follow them when
duke@435 338 // looking for the files. We check for a symbolic link after the
duke@435 339 // call to opendir in order to eliminate a small window where the
duke@435 340 // symlink can be exploited.
duke@435 341 //
duke@435 342 if (!is_directory_secure(usrdir_name)) {
duke@435 343 FREE_C_HEAP_ARRAY(char, usrdir_name);
duke@435 344 os::closedir(subdirp);
duke@435 345 continue;
duke@435 346 }
duke@435 347
duke@435 348 struct dirent* udentry;
duke@435 349 char* udbuf = NEW_C_HEAP_ARRAY(char, os::readdir_buf_size(usrdir_name));
duke@435 350 errno = 0;
duke@435 351 while ((udentry = os::readdir(subdirp, (struct dirent *)udbuf)) != NULL) {
duke@435 352
duke@435 353 if (filename_to_pid(udentry->d_name) == vmid) {
duke@435 354 struct stat statbuf;
duke@435 355 int result;
duke@435 356
duke@435 357 char* filename = NEW_C_HEAP_ARRAY(char,
duke@435 358 strlen(usrdir_name) + strlen(udentry->d_name) + 2);
duke@435 359
duke@435 360 strcpy(filename, usrdir_name);
duke@435 361 strcat(filename, "/");
duke@435 362 strcat(filename, udentry->d_name);
duke@435 363
duke@435 364 // don't follow symbolic links for the file
duke@435 365 RESTARTABLE(::lstat(filename, &statbuf), result);
duke@435 366 if (result == OS_ERR) {
duke@435 367 FREE_C_HEAP_ARRAY(char, filename);
duke@435 368 continue;
duke@435 369 }
duke@435 370
duke@435 371 // skip over files that are not regular files.
duke@435 372 if (!S_ISREG(statbuf.st_mode)) {
duke@435 373 FREE_C_HEAP_ARRAY(char, filename);
duke@435 374 continue;
duke@435 375 }
duke@435 376
duke@435 377 // compare and save filename with latest creation time
duke@435 378 if (statbuf.st_size > 0 && statbuf.st_ctime > oldest_ctime) {
duke@435 379
duke@435 380 if (statbuf.st_ctime > oldest_ctime) {
duke@435 381 char* user = strchr(dentry->d_name, '_') + 1;
duke@435 382
duke@435 383 if (oldest_user != NULL) FREE_C_HEAP_ARRAY(char, oldest_user);
duke@435 384 oldest_user = NEW_C_HEAP_ARRAY(char, strlen(user)+1);
duke@435 385
duke@435 386 strcpy(oldest_user, user);
duke@435 387 oldest_ctime = statbuf.st_ctime;
duke@435 388 }
duke@435 389 }
duke@435 390
duke@435 391 FREE_C_HEAP_ARRAY(char, filename);
duke@435 392 }
duke@435 393 }
duke@435 394 os::closedir(subdirp);
duke@435 395 FREE_C_HEAP_ARRAY(char, udbuf);
duke@435 396 FREE_C_HEAP_ARRAY(char, usrdir_name);
duke@435 397 }
duke@435 398 os::closedir(tmpdirp);
duke@435 399 FREE_C_HEAP_ARRAY(char, tdbuf);
duke@435 400
duke@435 401 return(oldest_user);
duke@435 402 }
duke@435 403
duke@435 404 // return the name of the user that owns the JVM indicated by the given vmid.
duke@435 405 //
duke@435 406 static char* get_user_name(int vmid, TRAPS) {
duke@435 407
duke@435 408 char psinfo_name[PATH_MAX];
duke@435 409 int result;
duke@435 410
duke@435 411 snprintf(psinfo_name, PATH_MAX, "/proc/%d/psinfo", vmid);
duke@435 412
duke@435 413 RESTARTABLE(::open(psinfo_name, O_RDONLY), result);
duke@435 414
duke@435 415 if (result != OS_ERR) {
duke@435 416 int fd = result;
duke@435 417
duke@435 418 psinfo_t psinfo;
duke@435 419 char* addr = (char*)&psinfo;
duke@435 420
duke@435 421 for (size_t remaining = sizeof(psinfo_t); remaining > 0;) {
duke@435 422
duke@435 423 RESTARTABLE(::read(fd, addr, remaining), result);
duke@435 424 if (result == OS_ERR) {
duke@435 425 THROW_MSG_0(vmSymbols::java_io_IOException(), "Read error");
duke@435 426 }
duke@435 427 remaining-=result;
duke@435 428 addr+=result;
duke@435 429 }
duke@435 430
duke@435 431 RESTARTABLE(::close(fd), result);
duke@435 432
duke@435 433 // get the user name for the effective user id of the process
duke@435 434 char* user_name = get_user_name(psinfo.pr_euid);
duke@435 435
duke@435 436 return user_name;
duke@435 437 }
duke@435 438
duke@435 439 if (result == OS_ERR && errno == EACCES) {
duke@435 440
duke@435 441 // In this case, the psinfo file for the process id existed,
duke@435 442 // but we didn't have permission to access it.
duke@435 443 THROW_MSG_0(vmSymbols::java_lang_IllegalArgumentException(),
duke@435 444 strerror(errno));
duke@435 445 }
duke@435 446
duke@435 447 // at this point, we don't know if the process id itself doesn't
duke@435 448 // exist or if the psinfo file doesn't exit. If the psinfo file
duke@435 449 // doesn't exist, then we are running on Solaris 2.5.1 or earlier.
duke@435 450 // since the structured procfs and old procfs interfaces can't be
duke@435 451 // mixed, we attempt to find the file through a directory search.
duke@435 452
duke@435 453 return get_user_name_slow(vmid, CHECK_NULL);
duke@435 454 }
duke@435 455
duke@435 456 // return the file name of the backing store file for the named
duke@435 457 // shared memory region for the given user name and vmid.
duke@435 458 //
duke@435 459 // the caller is expected to free the allocated memory.
duke@435 460 //
duke@435 461 static char* get_sharedmem_filename(const char* dirname, int vmid) {
duke@435 462
duke@435 463 // add 2 for the file separator and a NULL terminator.
duke@435 464 size_t nbytes = strlen(dirname) + UINT_CHARS + 2;
duke@435 465
duke@435 466 char* name = NEW_C_HEAP_ARRAY(char, nbytes);
duke@435 467 snprintf(name, nbytes, "%s/%d", dirname, vmid);
duke@435 468
duke@435 469 return name;
duke@435 470 }
duke@435 471
duke@435 472
duke@435 473 // remove file
duke@435 474 //
duke@435 475 // this method removes the file specified by the given path
duke@435 476 //
duke@435 477 static void remove_file(const char* path) {
duke@435 478
duke@435 479 int result;
duke@435 480
duke@435 481 // if the file is a directory, the following unlink will fail. since
duke@435 482 // we don't expect to find directories in the user temp directory, we
duke@435 483 // won't try to handle this situation. even if accidentially or
duke@435 484 // maliciously planted, the directory's presence won't hurt anything.
duke@435 485 //
duke@435 486 RESTARTABLE(::unlink(path), result);
duke@435 487 if (PrintMiscellaneous && Verbose && result == OS_ERR) {
duke@435 488 if (errno != ENOENT) {
duke@435 489 warning("Could not unlink shared memory backing"
duke@435 490 " store file %s : %s\n", path, strerror(errno));
duke@435 491 }
duke@435 492 }
duke@435 493 }
duke@435 494
duke@435 495
duke@435 496 // remove file
duke@435 497 //
duke@435 498 // this method removes the file with the given file name in the
duke@435 499 // named directory.
duke@435 500 //
duke@435 501 static void remove_file(const char* dirname, const char* filename) {
duke@435 502
duke@435 503 size_t nbytes = strlen(dirname) + strlen(filename) + 2;
duke@435 504 char* path = NEW_C_HEAP_ARRAY(char, nbytes);
duke@435 505
duke@435 506 strcpy(path, dirname);
duke@435 507 strcat(path, "/");
duke@435 508 strcat(path, filename);
duke@435 509
duke@435 510 remove_file(path);
duke@435 511
duke@435 512 FREE_C_HEAP_ARRAY(char, path);
duke@435 513 }
duke@435 514
duke@435 515
duke@435 516 // cleanup stale shared memory resources
duke@435 517 //
duke@435 518 // This method attempts to remove all stale shared memory files in
duke@435 519 // the named user temporary directory. It scans the named directory
duke@435 520 // for files matching the pattern ^$[0-9]*$. For each file found, the
duke@435 521 // process id is extracted from the file name and a test is run to
duke@435 522 // determine if the process is alive. If the process is not alive,
duke@435 523 // any stale file resources are removed.
duke@435 524 //
duke@435 525 static void cleanup_sharedmem_resources(const char* dirname) {
duke@435 526
duke@435 527 // open the user temp directory
duke@435 528 DIR* dirp = os::opendir(dirname);
duke@435 529
duke@435 530 if (dirp == NULL) {
duke@435 531 // directory doesn't exist, so there is nothing to cleanup
duke@435 532 return;
duke@435 533 }
duke@435 534
duke@435 535 if (!is_directory_secure(dirname)) {
duke@435 536 // the directory is not a secure directory
duke@435 537 return;
duke@435 538 }
duke@435 539
duke@435 540 // for each entry in the directory that matches the expected file
duke@435 541 // name pattern, determine if the file resources are stale and if
duke@435 542 // so, remove the file resources. Note, instrumented HotSpot processes
duke@435 543 // for this user may start and/or terminate during this search and
duke@435 544 // remove or create new files in this directory. The behavior of this
duke@435 545 // loop under these conditions is dependent upon the implementation of
duke@435 546 // opendir/readdir.
duke@435 547 //
duke@435 548 struct dirent* entry;
duke@435 549 char* dbuf = NEW_C_HEAP_ARRAY(char, os::readdir_buf_size(dirname));
duke@435 550 errno = 0;
duke@435 551 while ((entry = os::readdir(dirp, (struct dirent *)dbuf)) != NULL) {
duke@435 552
duke@435 553 pid_t pid = filename_to_pid(entry->d_name);
duke@435 554
duke@435 555 if (pid == 0) {
duke@435 556
duke@435 557 if (strcmp(entry->d_name, ".") != 0 && strcmp(entry->d_name, "..") != 0) {
duke@435 558
duke@435 559 // attempt to remove all unexpected files, except "." and ".."
duke@435 560 remove_file(dirname, entry->d_name);
duke@435 561 }
duke@435 562
duke@435 563 errno = 0;
duke@435 564 continue;
duke@435 565 }
duke@435 566
duke@435 567 // we now have a file name that converts to a valid integer
duke@435 568 // that could represent a process id . if this process id
duke@435 569 // matches the current process id or the process is not running,
duke@435 570 // then remove the stale file resources.
duke@435 571 //
duke@435 572 // process liveness is detected by sending signal number 0 to
duke@435 573 // the process id (see kill(2)). if kill determines that the
duke@435 574 // process does not exist, then the file resources are removed.
duke@435 575 // if kill determines that that we don't have permission to
duke@435 576 // signal the process, then the file resources are assumed to
duke@435 577 // be stale and are removed because the resources for such a
duke@435 578 // process should be in a different user specific directory.
duke@435 579 //
duke@435 580 if ((pid == os::current_process_id()) ||
duke@435 581 (kill(pid, 0) == OS_ERR && (errno == ESRCH || errno == EPERM))) {
duke@435 582
duke@435 583 remove_file(dirname, entry->d_name);
duke@435 584 }
duke@435 585 errno = 0;
duke@435 586 }
duke@435 587 os::closedir(dirp);
duke@435 588 FREE_C_HEAP_ARRAY(char, dbuf);
duke@435 589 }
duke@435 590
duke@435 591 // make the user specific temporary directory. Returns true if
duke@435 592 // the directory exists and is secure upon return. Returns false
duke@435 593 // if the directory exists but is either a symlink, is otherwise
duke@435 594 // insecure, or if an error occurred.
duke@435 595 //
duke@435 596 static bool make_user_tmp_dir(const char* dirname) {
duke@435 597
duke@435 598 // create the directory with 0755 permissions. note that the directory
duke@435 599 // will be owned by euid::egid, which may not be the same as uid::gid.
duke@435 600 //
duke@435 601 if (mkdir(dirname, S_IRWXU|S_IRGRP|S_IXGRP|S_IROTH|S_IXOTH) == OS_ERR) {
duke@435 602 if (errno == EEXIST) {
duke@435 603 // The directory already exists and was probably created by another
duke@435 604 // JVM instance. However, this could also be the result of a
duke@435 605 // deliberate symlink. Verify that the existing directory is safe.
duke@435 606 //
duke@435 607 if (!is_directory_secure(dirname)) {
duke@435 608 // directory is not secure
duke@435 609 if (PrintMiscellaneous && Verbose) {
duke@435 610 warning("%s directory is insecure\n", dirname);
duke@435 611 }
duke@435 612 return false;
duke@435 613 }
duke@435 614 }
duke@435 615 else {
duke@435 616 // we encountered some other failure while attempting
duke@435 617 // to create the directory
duke@435 618 //
duke@435 619 if (PrintMiscellaneous && Verbose) {
duke@435 620 warning("could not create directory %s: %s\n",
duke@435 621 dirname, strerror(errno));
duke@435 622 }
duke@435 623 return false;
duke@435 624 }
duke@435 625 }
duke@435 626 return true;
duke@435 627 }
duke@435 628
duke@435 629 // create the shared memory file resources
duke@435 630 //
duke@435 631 // This method creates the shared memory file with the given size
duke@435 632 // This method also creates the user specific temporary directory, if
duke@435 633 // it does not yet exist.
duke@435 634 //
duke@435 635 static int create_sharedmem_resources(const char* dirname, const char* filename, size_t size) {
duke@435 636
duke@435 637 // make the user temporary directory
duke@435 638 if (!make_user_tmp_dir(dirname)) {
duke@435 639 // could not make/find the directory or the found directory
duke@435 640 // was not secure
duke@435 641 return -1;
duke@435 642 }
duke@435 643
duke@435 644 int result;
duke@435 645
duke@435 646 RESTARTABLE(::open(filename, O_RDWR|O_CREAT|O_TRUNC, S_IREAD|S_IWRITE), result);
duke@435 647 if (result == OS_ERR) {
duke@435 648 if (PrintMiscellaneous && Verbose) {
duke@435 649 warning("could not create file %s: %s\n", filename, strerror(errno));
duke@435 650 }
duke@435 651 return -1;
duke@435 652 }
duke@435 653
duke@435 654 // save the file descriptor
duke@435 655 int fd = result;
duke@435 656
duke@435 657 // set the file size
duke@435 658 RESTARTABLE(::ftruncate(fd, (off_t)size), result);
duke@435 659 if (result == OS_ERR) {
duke@435 660 if (PrintMiscellaneous && Verbose) {
duke@435 661 warning("could not set shared memory file size: %s\n", strerror(errno));
duke@435 662 }
duke@435 663 RESTARTABLE(::close(fd), result);
duke@435 664 return -1;
duke@435 665 }
duke@435 666
duke@435 667 return fd;
duke@435 668 }
duke@435 669
duke@435 670 // open the shared memory file for the given user and vmid. returns
duke@435 671 // the file descriptor for the open file or -1 if the file could not
duke@435 672 // be opened.
duke@435 673 //
duke@435 674 static int open_sharedmem_file(const char* filename, int oflags, TRAPS) {
duke@435 675
duke@435 676 // open the file
duke@435 677 int result;
duke@435 678 RESTARTABLE(::open(filename, oflags), result);
duke@435 679 if (result == OS_ERR) {
duke@435 680 if (errno == ENOENT) {
duke@435 681 THROW_MSG_0(vmSymbols::java_lang_IllegalArgumentException(),
duke@435 682 "Process not found");
duke@435 683 }
duke@435 684 else if (errno == EACCES) {
duke@435 685 THROW_MSG_0(vmSymbols::java_lang_IllegalArgumentException(),
duke@435 686 "Permission denied");
duke@435 687 }
duke@435 688 else {
duke@435 689 THROW_MSG_0(vmSymbols::java_io_IOException(), strerror(errno));
duke@435 690 }
duke@435 691 }
duke@435 692
duke@435 693 return result;
duke@435 694 }
duke@435 695
duke@435 696 // create a named shared memory region. returns the address of the
duke@435 697 // memory region on success or NULL on failure. A return value of
duke@435 698 // NULL will ultimately disable the shared memory feature.
duke@435 699 //
duke@435 700 // On Solaris and Linux, the name space for shared memory objects
duke@435 701 // is the file system name space.
duke@435 702 //
duke@435 703 // A monitoring application attaching to a JVM does not need to know
duke@435 704 // the file system name of the shared memory object. However, it may
duke@435 705 // be convenient for applications to discover the existence of newly
duke@435 706 // created and terminating JVMs by watching the file system name space
duke@435 707 // for files being created or removed.
duke@435 708 //
duke@435 709 static char* mmap_create_shared(size_t size) {
duke@435 710
duke@435 711 int result;
duke@435 712 int fd;
duke@435 713 char* mapAddress;
duke@435 714
duke@435 715 int vmid = os::current_process_id();
duke@435 716
duke@435 717 char* user_name = get_user_name(geteuid());
duke@435 718
duke@435 719 if (user_name == NULL)
duke@435 720 return NULL;
duke@435 721
duke@435 722 char* dirname = get_user_tmp_dir(user_name);
duke@435 723 char* filename = get_sharedmem_filename(dirname, vmid);
duke@435 724
duke@435 725 // cleanup any stale shared memory files
duke@435 726 cleanup_sharedmem_resources(dirname);
duke@435 727
duke@435 728 assert(((size > 0) && (size % os::vm_page_size() == 0)),
duke@435 729 "unexpected PerfMemory region size");
duke@435 730
duke@435 731 fd = create_sharedmem_resources(dirname, filename, size);
duke@435 732
duke@435 733 FREE_C_HEAP_ARRAY(char, user_name);
duke@435 734 FREE_C_HEAP_ARRAY(char, dirname);
duke@435 735
duke@435 736 if (fd == -1) {
duke@435 737 FREE_C_HEAP_ARRAY(char, filename);
duke@435 738 return NULL;
duke@435 739 }
duke@435 740
duke@435 741 mapAddress = (char*)::mmap((char*)0, size, PROT_READ|PROT_WRITE, MAP_SHARED, fd, 0);
duke@435 742
duke@435 743 // attempt to close the file - restart it if it was interrupted,
duke@435 744 // but ignore other failures
duke@435 745 RESTARTABLE(::close(fd), result);
duke@435 746 assert(result != OS_ERR, "could not close file");
duke@435 747
duke@435 748 if (mapAddress == MAP_FAILED) {
duke@435 749 if (PrintMiscellaneous && Verbose) {
duke@435 750 warning("mmap failed - %s\n", strerror(errno));
duke@435 751 }
duke@435 752 remove_file(filename);
duke@435 753 FREE_C_HEAP_ARRAY(char, filename);
duke@435 754 return NULL;
duke@435 755 }
duke@435 756
duke@435 757 // save the file name for use in delete_shared_memory()
duke@435 758 backing_store_file_name = filename;
duke@435 759
duke@435 760 // clear the shared memory region
duke@435 761 (void)::memset((void*) mapAddress, 0, size);
duke@435 762
duke@435 763 return mapAddress;
duke@435 764 }
duke@435 765
duke@435 766 // release a named shared memory region
duke@435 767 //
duke@435 768 static void unmap_shared(char* addr, size_t bytes) {
duke@435 769 os::release_memory(addr, bytes);
duke@435 770 }
duke@435 771
duke@435 772 // create the PerfData memory region in shared memory.
duke@435 773 //
duke@435 774 static char* create_shared_memory(size_t size) {
duke@435 775
duke@435 776 // create the shared memory region.
duke@435 777 return mmap_create_shared(size);
duke@435 778 }
duke@435 779
duke@435 780 // delete the shared PerfData memory region
duke@435 781 //
duke@435 782 static void delete_shared_memory(char* addr, size_t size) {
duke@435 783
duke@435 784 // cleanup the persistent shared memory resources. since DestroyJavaVM does
duke@435 785 // not support unloading of the JVM, unmapping of the memory resource is
duke@435 786 // not performed. The memory will be reclaimed by the OS upon termination of
duke@435 787 // the process. The backing store file is deleted from the file system.
duke@435 788
duke@435 789 assert(!PerfDisableSharedMem, "shouldn't be here");
duke@435 790
duke@435 791 if (backing_store_file_name != NULL) {
duke@435 792 remove_file(backing_store_file_name);
duke@435 793 // Don't.. Free heap memory could deadlock os::abort() if it is called
duke@435 794 // from signal handler. OS will reclaim the heap memory.
duke@435 795 // FREE_C_HEAP_ARRAY(char, backing_store_file_name);
duke@435 796 backing_store_file_name = NULL;
duke@435 797 }
duke@435 798 }
duke@435 799
duke@435 800 // return the size of the file for the given file descriptor
duke@435 801 // or 0 if it is not a valid size for a shared memory file
duke@435 802 //
duke@435 803 static size_t sharedmem_filesize(int fd, TRAPS) {
duke@435 804
duke@435 805 struct stat statbuf;
duke@435 806 int result;
duke@435 807
duke@435 808 RESTARTABLE(::fstat(fd, &statbuf), result);
duke@435 809 if (result == OS_ERR) {
duke@435 810 if (PrintMiscellaneous && Verbose) {
duke@435 811 warning("fstat failed: %s\n", strerror(errno));
duke@435 812 }
duke@435 813 THROW_MSG_0(vmSymbols::java_io_IOException(),
duke@435 814 "Could not determine PerfMemory size");
duke@435 815 }
duke@435 816
duke@435 817 if ((statbuf.st_size == 0) ||
duke@435 818 ((size_t)statbuf.st_size % os::vm_page_size() != 0)) {
duke@435 819 THROW_MSG_0(vmSymbols::java_lang_Exception(),
duke@435 820 "Invalid PerfMemory size");
duke@435 821 }
duke@435 822
duke@435 823 return (size_t)statbuf.st_size;
duke@435 824 }
duke@435 825
duke@435 826 // attach to a named shared memory region.
duke@435 827 //
duke@435 828 static void mmap_attach_shared(const char* user, int vmid, PerfMemory::PerfMemoryMode mode, char** addr, size_t* sizep, TRAPS) {
duke@435 829
duke@435 830 char* mapAddress;
duke@435 831 int result;
duke@435 832 int fd;
duke@435 833 size_t size;
duke@435 834 const char* luser = NULL;
duke@435 835
duke@435 836 int mmap_prot;
duke@435 837 int file_flags;
duke@435 838
duke@435 839 ResourceMark rm;
duke@435 840
duke@435 841 // map the high level access mode to the appropriate permission
duke@435 842 // constructs for the file and the shared memory mapping.
duke@435 843 if (mode == PerfMemory::PERF_MODE_RO) {
duke@435 844 mmap_prot = PROT_READ;
duke@435 845 file_flags = O_RDONLY;
duke@435 846 }
duke@435 847 else if (mode == PerfMemory::PERF_MODE_RW) {
duke@435 848 #ifdef LATER
duke@435 849 mmap_prot = PROT_READ | PROT_WRITE;
duke@435 850 file_flags = O_RDWR;
duke@435 851 #else
duke@435 852 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
duke@435 853 "Unsupported access mode");
duke@435 854 #endif
duke@435 855 }
duke@435 856 else {
duke@435 857 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
duke@435 858 "Illegal access mode");
duke@435 859 }
duke@435 860
duke@435 861 if (user == NULL || strlen(user) == 0) {
duke@435 862 luser = get_user_name(vmid, CHECK);
duke@435 863 }
duke@435 864 else {
duke@435 865 luser = user;
duke@435 866 }
duke@435 867
duke@435 868 if (luser == NULL) {
duke@435 869 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
duke@435 870 "Could not map vmid to user Name");
duke@435 871 }
duke@435 872
duke@435 873 char* dirname = get_user_tmp_dir(luser);
duke@435 874
duke@435 875 // since we don't follow symbolic links when creating the backing
duke@435 876 // store file, we don't follow them when attaching either.
duke@435 877 //
duke@435 878 if (!is_directory_secure(dirname)) {
duke@435 879 FREE_C_HEAP_ARRAY(char, dirname);
duke@435 880 THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(),
duke@435 881 "Process not found");
duke@435 882 }
duke@435 883
duke@435 884 char* filename = get_sharedmem_filename(dirname, vmid);
duke@435 885
duke@435 886 // copy heap memory to resource memory. the open_sharedmem_file
duke@435 887 // method below need to use the filename, but could throw an
duke@435 888 // exception. using a resource array prevents the leak that
duke@435 889 // would otherwise occur.
duke@435 890 char* rfilename = NEW_RESOURCE_ARRAY(char, strlen(filename) + 1);
duke@435 891 strcpy(rfilename, filename);
duke@435 892
duke@435 893 // free the c heap resources that are no longer needed
duke@435 894 if (luser != user) FREE_C_HEAP_ARRAY(char, luser);
duke@435 895 FREE_C_HEAP_ARRAY(char, dirname);
duke@435 896 FREE_C_HEAP_ARRAY(char, filename);
duke@435 897
duke@435 898 // open the shared memory file for the give vmid
duke@435 899 fd = open_sharedmem_file(rfilename, file_flags, CHECK);
duke@435 900 assert(fd != OS_ERR, "unexpected value");
duke@435 901
duke@435 902 if (*sizep == 0) {
duke@435 903 size = sharedmem_filesize(fd, CHECK);
duke@435 904 assert(size != 0, "unexpected size");
duke@435 905 }
duke@435 906
duke@435 907 mapAddress = (char*)::mmap((char*)0, size, mmap_prot, MAP_SHARED, fd, 0);
duke@435 908
duke@435 909 // attempt to close the file - restart if it gets interrupted,
duke@435 910 // but ignore other failures
duke@435 911 RESTARTABLE(::close(fd), result);
duke@435 912 assert(result != OS_ERR, "could not close file");
duke@435 913
duke@435 914 if (mapAddress == MAP_FAILED) {
duke@435 915 if (PrintMiscellaneous && Verbose) {
duke@435 916 warning("mmap failed: %s\n", strerror(errno));
duke@435 917 }
duke@435 918 THROW_MSG(vmSymbols::java_lang_OutOfMemoryError(),
duke@435 919 "Could not map PerfMemory");
duke@435 920 }
duke@435 921
duke@435 922 *addr = mapAddress;
duke@435 923 *sizep = size;
duke@435 924
duke@435 925 if (PerfTraceMemOps) {
duke@435 926 tty->print("mapped " SIZE_FORMAT " bytes for vmid %d at "
duke@435 927 INTPTR_FORMAT "\n", size, vmid, (void*)mapAddress);
duke@435 928 }
duke@435 929 }
duke@435 930
duke@435 931
duke@435 932
duke@435 933
duke@435 934 // create the PerfData memory region
duke@435 935 //
duke@435 936 // This method creates the memory region used to store performance
duke@435 937 // data for the JVM. The memory may be created in standard or
duke@435 938 // shared memory.
duke@435 939 //
duke@435 940 void PerfMemory::create_memory_region(size_t size) {
duke@435 941
duke@435 942 if (PerfDisableSharedMem) {
duke@435 943 // do not share the memory for the performance data.
duke@435 944 _start = create_standard_memory(size);
duke@435 945 }
duke@435 946 else {
duke@435 947 _start = create_shared_memory(size);
duke@435 948 if (_start == NULL) {
duke@435 949
duke@435 950 // creation of the shared memory region failed, attempt
duke@435 951 // to create a contiguous, non-shared memory region instead.
duke@435 952 //
duke@435 953 if (PrintMiscellaneous && Verbose) {
duke@435 954 warning("Reverting to non-shared PerfMemory region.\n");
duke@435 955 }
duke@435 956 PerfDisableSharedMem = true;
duke@435 957 _start = create_standard_memory(size);
duke@435 958 }
duke@435 959 }
duke@435 960
duke@435 961 if (_start != NULL) _capacity = size;
duke@435 962
duke@435 963 }
duke@435 964
duke@435 965 // delete the PerfData memory region
duke@435 966 //
duke@435 967 // This method deletes the memory region used to store performance
duke@435 968 // data for the JVM. The memory region indicated by the <address, size>
duke@435 969 // tuple will be inaccessible after a call to this method.
duke@435 970 //
duke@435 971 void PerfMemory::delete_memory_region() {
duke@435 972
duke@435 973 assert((start() != NULL && capacity() > 0), "verify proper state");
duke@435 974
duke@435 975 // If user specifies PerfDataSaveFile, it will save the performance data
duke@435 976 // to the specified file name no matter whether PerfDataSaveToFile is specified
duke@435 977 // or not. In other word, -XX:PerfDataSaveFile=.. overrides flag
duke@435 978 // -XX:+PerfDataSaveToFile.
duke@435 979 if (PerfDataSaveToFile || PerfDataSaveFile != NULL) {
duke@435 980 save_memory_to_file(start(), capacity());
duke@435 981 }
duke@435 982
duke@435 983 if (PerfDisableSharedMem) {
duke@435 984 delete_standard_memory(start(), capacity());
duke@435 985 }
duke@435 986 else {
duke@435 987 delete_shared_memory(start(), capacity());
duke@435 988 }
duke@435 989 }
duke@435 990
duke@435 991 // attach to the PerfData memory region for another JVM
duke@435 992 //
duke@435 993 // This method returns an <address, size> tuple that points to
duke@435 994 // a memory buffer that is kept reasonably synchronized with
duke@435 995 // the PerfData memory region for the indicated JVM. This
duke@435 996 // buffer may be kept in synchronization via shared memory
duke@435 997 // or some other mechanism that keeps the buffer updated.
duke@435 998 //
duke@435 999 // If the JVM chooses not to support the attachability feature,
duke@435 1000 // this method should throw an UnsupportedOperation exception.
duke@435 1001 //
duke@435 1002 // This implementation utilizes named shared memory to map
duke@435 1003 // the indicated process's PerfData memory region into this JVMs
duke@435 1004 // address space.
duke@435 1005 //
duke@435 1006 void PerfMemory::attach(const char* user, int vmid, PerfMemoryMode mode, char** addrp, size_t* sizep, TRAPS) {
duke@435 1007
duke@435 1008 if (vmid == 0 || vmid == os::current_process_id()) {
duke@435 1009 *addrp = start();
duke@435 1010 *sizep = capacity();
duke@435 1011 return;
duke@435 1012 }
duke@435 1013
duke@435 1014 mmap_attach_shared(user, vmid, mode, addrp, sizep, CHECK);
duke@435 1015 }
duke@435 1016
duke@435 1017 // detach from the PerfData memory region of another JVM
duke@435 1018 //
duke@435 1019 // This method detaches the PerfData memory region of another
duke@435 1020 // JVM, specified as an <address, size> tuple of a buffer
duke@435 1021 // in this process's address space. This method may perform
duke@435 1022 // arbitrary actions to accomplish the detachment. The memory
duke@435 1023 // region specified by <address, size> will be inaccessible after
duke@435 1024 // a call to this method.
duke@435 1025 //
duke@435 1026 // If the JVM chooses not to support the attachability feature,
duke@435 1027 // this method should throw an UnsupportedOperation exception.
duke@435 1028 //
duke@435 1029 // This implementation utilizes named shared memory to detach
duke@435 1030 // the indicated process's PerfData memory region from this
duke@435 1031 // process's address space.
duke@435 1032 //
duke@435 1033 void PerfMemory::detach(char* addr, size_t bytes, TRAPS) {
duke@435 1034
duke@435 1035 assert(addr != 0, "address sanity check");
duke@435 1036 assert(bytes > 0, "capacity sanity check");
duke@435 1037
duke@435 1038 if (PerfMemory::contains(addr) || PerfMemory::contains(addr + bytes - 1)) {
duke@435 1039 // prevent accidental detachment of this process's PerfMemory region
duke@435 1040 return;
duke@435 1041 }
duke@435 1042
duke@435 1043 unmap_shared(addr, bytes);
duke@435 1044 }
duke@435 1045
duke@435 1046 char* PerfMemory::backing_store_filename() {
duke@435 1047 return backing_store_file_name;
duke@435 1048 }

mercurial