3 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
4 # Use of this source code is governed by a BSD-style license that can be
5 # found in the LICENSE file.
7 # Usage: make_more_helpers.sh <directory_within_contents> <app_name>
9 # This script creates additional helper .app bundles for Chromium, based on
10 # the existing helper .app bundle, changing their Mach-O header's flags to
11 # enable and disable various features. Based on Chromium Helper.app, it will
12 # create Chromium Helper EH.app, which has the MH_NO_HEAP_EXECUTION bit
13 # cleared to support Chromium child processes that require an executable heap,
14 # and Chromium Helper NP.app, which has the MH_PIE bit cleared to support
15 # Chromium child processes that cannot tolerate ASLR.
17 # This script expects to be called from the chrome_exe target as a postbuild,
18 # and operates directly within the built-up browser app's versioned directory.
20 # Each helper is adjusted by giving it the proper bundle name, renaming the
21 # executable, adjusting several Info.plist keys, and changing the executable's
27 local containing_dir
="${1}"
32 local helper_name
="${app_name} Helper"
33 local helper_stem
="${containing_dir}/${helper_name}"
34 local original_helper
="${helper_stem}.app"
35 if [[ ! -d "${original_helper}" ]]; then
36 echo "${0}: error: ${original_helper} is a required directory" >& 2
39 local original_helper_exe
="${original_helper}/Contents/MacOS/${helper_name}"
40 if [[ ! -f "${original_helper_exe}" ]]; then
41 echo "${0}: error: ${original_helper_exe} is a required file" >& 2
45 local feature_helper
="${helper_stem} ${feature}.app"
47 rsync
-acC --delete --include '*.so' "${original_helper}/" "${feature_helper}"
49 local helper_feature
="${helper_name} ${feature}"
50 local helper_feature_exe
="${feature_helper}/Contents/MacOS/${helper_feature}"
51 mv "${feature_helper}/Contents/MacOS/${helper_name}" "${helper_feature_exe}"
53 local change_flags
="$(dirname "${0}")/change_mach_o_flags.py"
54 "${change_flags}" ${flags} "${helper_feature_exe}"
56 local feature_info
="${feature_helper}/Contents/Info"
57 local feature_info_plist
="${feature_info}.plist"
59 defaults
write "${feature_info}" "CFBundleDisplayName" "${helper_feature}"
60 defaults
write "${feature_info}" "CFBundleExecutable" "${helper_feature}"
62 cfbundleid
="$(defaults read "${feature_info}" "CFBundleIdentifier
")"
63 feature_cfbundleid
="${cfbundleid}.${feature}"
64 defaults
write "${feature_info}" "CFBundleIdentifier" "${feature_cfbundleid}"
66 cfbundlename
="$(defaults read "${feature_info}" "CFBundleName
")"
67 feature_cfbundlename
="${cfbundlename} ${feature}"
68 defaults
write "${feature_info}" "CFBundleName" "${feature_cfbundlename}"
70 # As usual, defaults might have put the plist into whatever format excites
71 # it, but Info.plists get converted back to the expected XML format.
72 plutil
-convert xml1
"${feature_info_plist}"
74 # `defaults` also changes the file permissions, so make the file
75 # world-readable again.
76 chmod a
+r
"${feature_info_plist}"
79 if [[ ${#} -ne 2 ]]; then
80 echo "usage: ${0} <directory_within_contents> <app_name>" >& 2
84 DIRECTORY_WITHIN_CONTENTS
="${1}"
87 CONTENTS_DIR
="${BUILT_PRODUCTS_DIR}/${CONTENTS_FOLDER_PATH}"
88 CONTAINING_DIR
="${CONTENTS_DIR}/${DIRECTORY_WITHIN_CONTENTS}"
90 make_helper
"${CONTAINING_DIR}" "${APP_NAME}" "EH" "--executable-heap"
91 make_helper
"${CONTAINING_DIR}" "${APP_NAME}" "NP" "--no-pie"