xref: /aosp_15_r20/external/kotlinpoet/gradlew (revision 3c321d951dd070fb96f8ba59e952ffc3131379a0)
1*3c321d95SSadaf Ebrahimi#!/bin/sh
2*3c321d95SSadaf Ebrahimi
3*3c321d95SSadaf Ebrahimi#
4*3c321d95SSadaf Ebrahimi# Copyright © 2015-2021 the original authors.
5*3c321d95SSadaf Ebrahimi#
6*3c321d95SSadaf Ebrahimi# Licensed under the Apache License, Version 2.0 (the "License");
7*3c321d95SSadaf Ebrahimi# you may not use this file except in compliance with the License.
8*3c321d95SSadaf Ebrahimi# You may obtain a copy of the License at
9*3c321d95SSadaf Ebrahimi#
10*3c321d95SSadaf Ebrahimi#      https://www.apache.org/licenses/LICENSE-2.0
11*3c321d95SSadaf Ebrahimi#
12*3c321d95SSadaf Ebrahimi# Unless required by applicable law or agreed to in writing, software
13*3c321d95SSadaf Ebrahimi# distributed under the License is distributed on an "AS IS" BASIS,
14*3c321d95SSadaf Ebrahimi# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15*3c321d95SSadaf Ebrahimi# See the License for the specific language governing permissions and
16*3c321d95SSadaf Ebrahimi# limitations under the License.
17*3c321d95SSadaf Ebrahimi#
18*3c321d95SSadaf Ebrahimi# SPDX-License-Identifier: Apache-2.0
19*3c321d95SSadaf Ebrahimi#
20*3c321d95SSadaf Ebrahimi
21*3c321d95SSadaf Ebrahimi##############################################################################
22*3c321d95SSadaf Ebrahimi#
23*3c321d95SSadaf Ebrahimi#   Gradle start up script for POSIX generated by Gradle.
24*3c321d95SSadaf Ebrahimi#
25*3c321d95SSadaf Ebrahimi#   Important for running:
26*3c321d95SSadaf Ebrahimi#
27*3c321d95SSadaf Ebrahimi#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
28*3c321d95SSadaf Ebrahimi#       noncompliant, but you have some other compliant shell such as ksh or
29*3c321d95SSadaf Ebrahimi#       bash, then to run this script, type that shell name before the whole
30*3c321d95SSadaf Ebrahimi#       command line, like:
31*3c321d95SSadaf Ebrahimi#
32*3c321d95SSadaf Ebrahimi#           ksh Gradle
33*3c321d95SSadaf Ebrahimi#
34*3c321d95SSadaf Ebrahimi#       Busybox and similar reduced shells will NOT work, because this script
35*3c321d95SSadaf Ebrahimi#       requires all of these POSIX shell features:
36*3c321d95SSadaf Ebrahimi#         * functions;
37*3c321d95SSadaf Ebrahimi#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
38*3c321d95SSadaf Ebrahimi#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
39*3c321d95SSadaf Ebrahimi#         * compound commands having a testable exit status, especially «case»;
40*3c321d95SSadaf Ebrahimi#         * various built-in commands including «command», «set», and «ulimit».
41*3c321d95SSadaf Ebrahimi#
42*3c321d95SSadaf Ebrahimi#   Important for patching:
43*3c321d95SSadaf Ebrahimi#
44*3c321d95SSadaf Ebrahimi#   (2) This script targets any POSIX shell, so it avoids extensions provided
45*3c321d95SSadaf Ebrahimi#       by Bash, Ksh, etc; in particular arrays are avoided.
46*3c321d95SSadaf Ebrahimi#
47*3c321d95SSadaf Ebrahimi#       The "traditional" practice of packing multiple parameters into a
48*3c321d95SSadaf Ebrahimi#       space-separated string is a well documented source of bugs and security
49*3c321d95SSadaf Ebrahimi#       problems, so this is (mostly) avoided, by progressively accumulating
50*3c321d95SSadaf Ebrahimi#       options in "$@", and eventually passing that to Java.
51*3c321d95SSadaf Ebrahimi#
52*3c321d95SSadaf Ebrahimi#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
53*3c321d95SSadaf Ebrahimi#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
54*3c321d95SSadaf Ebrahimi#       see the in-line comments for details.
55*3c321d95SSadaf Ebrahimi#
56*3c321d95SSadaf Ebrahimi#       There are tweaks for specific operating systems such as AIX, CygWin,
57*3c321d95SSadaf Ebrahimi#       Darwin, MinGW, and NonStop.
58*3c321d95SSadaf Ebrahimi#
59*3c321d95SSadaf Ebrahimi#   (3) This script is generated from the Groovy template
60*3c321d95SSadaf Ebrahimi#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
61*3c321d95SSadaf Ebrahimi#       within the Gradle project.
62*3c321d95SSadaf Ebrahimi#
63*3c321d95SSadaf Ebrahimi#       You can find Gradle at https://github.com/gradle/gradle/.
64*3c321d95SSadaf Ebrahimi#
65*3c321d95SSadaf Ebrahimi##############################################################################
66*3c321d95SSadaf Ebrahimi
67*3c321d95SSadaf Ebrahimi# Attempt to set APP_HOME
68*3c321d95SSadaf Ebrahimi
69*3c321d95SSadaf Ebrahimi# Resolve links: $0 may be a link
70*3c321d95SSadaf Ebrahimiapp_path=$0
71*3c321d95SSadaf Ebrahimi
72*3c321d95SSadaf Ebrahimi# Need this for daisy-chained symlinks.
73*3c321d95SSadaf Ebrahimiwhile
74*3c321d95SSadaf Ebrahimi    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
75*3c321d95SSadaf Ebrahimi    [ -h "$app_path" ]
76*3c321d95SSadaf Ebrahimido
77*3c321d95SSadaf Ebrahimi    ls=$( ls -ld "$app_path" )
78*3c321d95SSadaf Ebrahimi    link=${ls#*' -> '}
79*3c321d95SSadaf Ebrahimi    case $link in             #(
80*3c321d95SSadaf Ebrahimi      /*)   app_path=$link ;; #(
81*3c321d95SSadaf Ebrahimi      *)    app_path=$APP_HOME$link ;;
82*3c321d95SSadaf Ebrahimi    esac
83*3c321d95SSadaf Ebrahimidone
84*3c321d95SSadaf Ebrahimi
85*3c321d95SSadaf Ebrahimi# This is normally unused
86*3c321d95SSadaf Ebrahimi# shellcheck disable=SC2034
87*3c321d95SSadaf EbrahimiAPP_BASE_NAME=${0##*/}
88*3c321d95SSadaf Ebrahimi# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
89*3c321d95SSadaf EbrahimiAPP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s
90*3c321d95SSadaf Ebrahimi' "$PWD" ) || exit
91*3c321d95SSadaf Ebrahimi
92*3c321d95SSadaf Ebrahimi# Use the maximum available, or set MAX_FD != -1 to use that value.
93*3c321d95SSadaf EbrahimiMAX_FD=maximum
94*3c321d95SSadaf Ebrahimi
95*3c321d95SSadaf Ebrahimiwarn () {
96*3c321d95SSadaf Ebrahimi    echo "$*"
97*3c321d95SSadaf Ebrahimi} >&2
98*3c321d95SSadaf Ebrahimi
99*3c321d95SSadaf Ebrahimidie () {
100*3c321d95SSadaf Ebrahimi    echo
101*3c321d95SSadaf Ebrahimi    echo "$*"
102*3c321d95SSadaf Ebrahimi    echo
103*3c321d95SSadaf Ebrahimi    exit 1
104*3c321d95SSadaf Ebrahimi} >&2
105*3c321d95SSadaf Ebrahimi
106*3c321d95SSadaf Ebrahimi# OS specific support (must be 'true' or 'false').
107*3c321d95SSadaf Ebrahimicygwin=false
108*3c321d95SSadaf Ebrahimimsys=false
109*3c321d95SSadaf Ebrahimidarwin=false
110*3c321d95SSadaf Ebrahiminonstop=false
111*3c321d95SSadaf Ebrahimicase "$( uname )" in                #(
112*3c321d95SSadaf Ebrahimi  CYGWIN* )         cygwin=true  ;; #(
113*3c321d95SSadaf Ebrahimi  Darwin* )         darwin=true  ;; #(
114*3c321d95SSadaf Ebrahimi  MSYS* | MINGW* )  msys=true    ;; #(
115*3c321d95SSadaf Ebrahimi  NONSTOP* )        nonstop=true ;;
116*3c321d95SSadaf Ebrahimiesac
117*3c321d95SSadaf Ebrahimi
118*3c321d95SSadaf EbrahimiCLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
119*3c321d95SSadaf Ebrahimi
120*3c321d95SSadaf Ebrahimi
121*3c321d95SSadaf Ebrahimi# Determine the Java command to use to start the JVM.
122*3c321d95SSadaf Ebrahimiif [ -n "$JAVA_HOME" ] ; then
123*3c321d95SSadaf Ebrahimi    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
124*3c321d95SSadaf Ebrahimi        # IBM's JDK on AIX uses strange locations for the executables
125*3c321d95SSadaf Ebrahimi        JAVACMD=$JAVA_HOME/jre/sh/java
126*3c321d95SSadaf Ebrahimi    else
127*3c321d95SSadaf Ebrahimi        JAVACMD=$JAVA_HOME/bin/java
128*3c321d95SSadaf Ebrahimi    fi
129*3c321d95SSadaf Ebrahimi    if [ ! -x "$JAVACMD" ] ; then
130*3c321d95SSadaf Ebrahimi        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
131*3c321d95SSadaf Ebrahimi
132*3c321d95SSadaf EbrahimiPlease set the JAVA_HOME variable in your environment to match the
133*3c321d95SSadaf Ebrahimilocation of your Java installation."
134*3c321d95SSadaf Ebrahimi    fi
135*3c321d95SSadaf Ebrahimielse
136*3c321d95SSadaf Ebrahimi    JAVACMD=java
137*3c321d95SSadaf Ebrahimi    if ! command -v java >/dev/null 2>&1
138*3c321d95SSadaf Ebrahimi    then
139*3c321d95SSadaf Ebrahimi        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
140*3c321d95SSadaf Ebrahimi
141*3c321d95SSadaf EbrahimiPlease set the JAVA_HOME variable in your environment to match the
142*3c321d95SSadaf Ebrahimilocation of your Java installation."
143*3c321d95SSadaf Ebrahimi    fi
144*3c321d95SSadaf Ebrahimifi
145*3c321d95SSadaf Ebrahimi
146*3c321d95SSadaf Ebrahimi# Increase the maximum file descriptors if we can.
147*3c321d95SSadaf Ebrahimiif ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
148*3c321d95SSadaf Ebrahimi    case $MAX_FD in #(
149*3c321d95SSadaf Ebrahimi      max*)
150*3c321d95SSadaf Ebrahimi        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
151*3c321d95SSadaf Ebrahimi        # shellcheck disable=SC2039,SC3045
152*3c321d95SSadaf Ebrahimi        MAX_FD=$( ulimit -H -n ) ||
153*3c321d95SSadaf Ebrahimi            warn "Could not query maximum file descriptor limit"
154*3c321d95SSadaf Ebrahimi    esac
155*3c321d95SSadaf Ebrahimi    case $MAX_FD in  #(
156*3c321d95SSadaf Ebrahimi      '' | soft) :;; #(
157*3c321d95SSadaf Ebrahimi      *)
158*3c321d95SSadaf Ebrahimi        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
159*3c321d95SSadaf Ebrahimi        # shellcheck disable=SC2039,SC3045
160*3c321d95SSadaf Ebrahimi        ulimit -n "$MAX_FD" ||
161*3c321d95SSadaf Ebrahimi            warn "Could not set maximum file descriptor limit to $MAX_FD"
162*3c321d95SSadaf Ebrahimi    esac
163*3c321d95SSadaf Ebrahimifi
164*3c321d95SSadaf Ebrahimi
165*3c321d95SSadaf Ebrahimi# Collect all arguments for the java command, stacking in reverse order:
166*3c321d95SSadaf Ebrahimi#   * args from the command line
167*3c321d95SSadaf Ebrahimi#   * the main class name
168*3c321d95SSadaf Ebrahimi#   * -classpath
169*3c321d95SSadaf Ebrahimi#   * -D...appname settings
170*3c321d95SSadaf Ebrahimi#   * --module-path (only if needed)
171*3c321d95SSadaf Ebrahimi#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
172*3c321d95SSadaf Ebrahimi
173*3c321d95SSadaf Ebrahimi# For Cygwin or MSYS, switch paths to Windows format before running java
174*3c321d95SSadaf Ebrahimiif "$cygwin" || "$msys" ; then
175*3c321d95SSadaf Ebrahimi    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
176*3c321d95SSadaf Ebrahimi    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
177*3c321d95SSadaf Ebrahimi
178*3c321d95SSadaf Ebrahimi    JAVACMD=$( cygpath --unix "$JAVACMD" )
179*3c321d95SSadaf Ebrahimi
180*3c321d95SSadaf Ebrahimi    # Now convert the arguments - kludge to limit ourselves to /bin/sh
181*3c321d95SSadaf Ebrahimi    for arg do
182*3c321d95SSadaf Ebrahimi        if
183*3c321d95SSadaf Ebrahimi            case $arg in                                #(
184*3c321d95SSadaf Ebrahimi              -*)   false ;;                            # don't mess with options #(
185*3c321d95SSadaf Ebrahimi              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
186*3c321d95SSadaf Ebrahimi                    [ -e "$t" ] ;;                      #(
187*3c321d95SSadaf Ebrahimi              *)    false ;;
188*3c321d95SSadaf Ebrahimi            esac
189*3c321d95SSadaf Ebrahimi        then
190*3c321d95SSadaf Ebrahimi            arg=$( cygpath --path --ignore --mixed "$arg" )
191*3c321d95SSadaf Ebrahimi        fi
192*3c321d95SSadaf Ebrahimi        # Roll the args list around exactly as many times as the number of
193*3c321d95SSadaf Ebrahimi        # args, so each arg winds up back in the position where it started, but
194*3c321d95SSadaf Ebrahimi        # possibly modified.
195*3c321d95SSadaf Ebrahimi        #
196*3c321d95SSadaf Ebrahimi        # NB: a `for` loop captures its iteration list before it begins, so
197*3c321d95SSadaf Ebrahimi        # changing the positional parameters here affects neither the number of
198*3c321d95SSadaf Ebrahimi        # iterations, nor the values presented in `arg`.
199*3c321d95SSadaf Ebrahimi        shift                   # remove old arg
200*3c321d95SSadaf Ebrahimi        set -- "$@" "$arg"      # push replacement arg
201*3c321d95SSadaf Ebrahimi    done
202*3c321d95SSadaf Ebrahimifi
203*3c321d95SSadaf Ebrahimi
204*3c321d95SSadaf Ebrahimi
205*3c321d95SSadaf Ebrahimi# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
206*3c321d95SSadaf EbrahimiDEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
207*3c321d95SSadaf Ebrahimi
208*3c321d95SSadaf Ebrahimi# Collect all arguments for the java command:
209*3c321d95SSadaf Ebrahimi#   * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
210*3c321d95SSadaf Ebrahimi#     and any embedded shellness will be escaped.
211*3c321d95SSadaf Ebrahimi#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
212*3c321d95SSadaf Ebrahimi#     treated as '${Hostname}' itself on the command line.
213*3c321d95SSadaf Ebrahimi
214*3c321d95SSadaf Ebrahimiset -- \
215*3c321d95SSadaf Ebrahimi        "-Dorg.gradle.appname=$APP_BASE_NAME" \
216*3c321d95SSadaf Ebrahimi        -classpath "$CLASSPATH" \
217*3c321d95SSadaf Ebrahimi        org.gradle.wrapper.GradleWrapperMain \
218*3c321d95SSadaf Ebrahimi        "$@"
219*3c321d95SSadaf Ebrahimi
220*3c321d95SSadaf Ebrahimi# Stop when "xargs" is not available.
221*3c321d95SSadaf Ebrahimiif ! command -v xargs >/dev/null 2>&1
222*3c321d95SSadaf Ebrahimithen
223*3c321d95SSadaf Ebrahimi    die "xargs is not available"
224*3c321d95SSadaf Ebrahimifi
225*3c321d95SSadaf Ebrahimi
226*3c321d95SSadaf Ebrahimi# Use "xargs" to parse quoted args.
227*3c321d95SSadaf Ebrahimi#
228*3c321d95SSadaf Ebrahimi# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
229*3c321d95SSadaf Ebrahimi#
230*3c321d95SSadaf Ebrahimi# In Bash we could simply go:
231*3c321d95SSadaf Ebrahimi#
232*3c321d95SSadaf Ebrahimi#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
233*3c321d95SSadaf Ebrahimi#   set -- "${ARGS[@]}" "$@"
234*3c321d95SSadaf Ebrahimi#
235*3c321d95SSadaf Ebrahimi# but POSIX shell has neither arrays nor command substitution, so instead we
236*3c321d95SSadaf Ebrahimi# post-process each arg (as a line of input to sed) to backslash-escape any
237*3c321d95SSadaf Ebrahimi# character that might be a shell metacharacter, then use eval to reverse
238*3c321d95SSadaf Ebrahimi# that process (while maintaining the separation between arguments), and wrap
239*3c321d95SSadaf Ebrahimi# the whole thing up as a single "set" statement.
240*3c321d95SSadaf Ebrahimi#
241*3c321d95SSadaf Ebrahimi# This will of course break if any of these variables contains a newline or
242*3c321d95SSadaf Ebrahimi# an unmatched quote.
243*3c321d95SSadaf Ebrahimi#
244*3c321d95SSadaf Ebrahimi
245*3c321d95SSadaf Ebrahimieval "set -- $(
246*3c321d95SSadaf Ebrahimi        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
247*3c321d95SSadaf Ebrahimi        xargs -n1 |
248*3c321d95SSadaf Ebrahimi        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
249*3c321d95SSadaf Ebrahimi        tr '\n' ' '
250*3c321d95SSadaf Ebrahimi    )" '"$@"'
251*3c321d95SSadaf Ebrahimi
252*3c321d95SSadaf Ebrahimiexec "$JAVACMD" "$@"
253