support/scripts/br2-external

   1 #!/bin/bash
   2 set -e
   3
   4 # This script must be able to run with bash-3.1, so it can't use
   5 # associative arrays. Instead, it emulates them using 'eval'. It
   6 # can however use indexed arrays, supported since at least bash-3.0.
   7
   8 # The names of the br2-external trees, once validated.
   9 declare -a BR2_EXT_NAMES
  10
  11 # URL to manual for help in converting old br2-external trees.
  12 # Escape '#' so that make does not consider it a comment.
  13 MANUAL_URL='https://buildroot.org/manual.html\#br2-external-converting'
  14
  15 main() {
  16     local OPT OPTARG
  17     local br2_ext ofile ofmt
  18
  19     while getopts :hkmo: OPT; do
  20         case "${OPT}" in
  21         h)  help; exit 0;;
  22         o)  ofile="${OPTARG}";;
  23         k)  ofmt="kconfig";;
  24         m)  ofmt="mk";;
  25         :)  error "option '%s' expects a mandatory argument\n" "${OPTARG}";;
  26         \?) error "unknown option '%s'\n" "${OPTARG}";;
  27         esac
  28     done
  29     # Forget options; keep only positional args
  30     shift $((OPTIND-1))
  31
  32     case "${ofmt}" in
  33     mk|kconfig)
  34         ;;
  35     *)  error "no output format specified (-m/-k)\n";;
  36     esac
  37     if [ -z "${ofile}" ]; then
  38         error "no output file specified (-o)\n"
  39     fi
  40
  41     exec >"${ofile}"
  42
  43     do_validate ${@//:/ }
  44
  45     do_${ofmt}
  46 }
  47
  48 # Validates the br2-external trees passed as arguments. Makes each of
  49 # them canonical and store them in the global arrays BR2_EXT_NAMES
  50 # and BR2_EXT_PATHS.
  51 #
  52 # Note: since this script is always first called from Makefile context
  53 # to generate the Makefile fragment before it is called to generate the
  54 # Kconfig snippet, we're sure that any error in do_validate will be
  55 # interpreted in Makefile context. Going up to generating the Kconfig
  56 # snippet means that there were no error.
  57 #
  58 do_validate() {
  59     local br2_ext
  60
  61     if [ ${#} -eq 0 ]; then
  62         # No br2-external tree is valid
  63         return
  64     fi
  65
  66     for br2_ext in "${@}"; do
  67         do_validate_one "${br2_ext}"
  68     done
  69 }
  70
  71 do_validate_one() {
  72     local br2_ext="${1}"
  73     local br2_name br2_desc n d
  74
  75     if [ ! -d "${br2_ext}" ]; then
  76         error "'%s': no such file or directory\n" "${br2_ext}"
  77     fi
  78     if [ ! -r "${br2_ext}" -o ! -x "${br2_ext}" ]; then
  79         error "'%s': permission denied\n" "${br2_ext}"
  80     fi
  81     if [ ! -f "${br2_ext}/external.desc" ]; then
  82         error "'%s': does not have a name (in 'external.desc'). See %s\n" \
  83             "${br2_ext}" "${MANUAL_URL}"
  84     fi
  85     br2_name="$(sed -r -e '/^name: +(.*)$/!d; s//\1/' "${br2_ext}/external.desc")"
  86     if [ -z "${br2_name}" ]; then
  87         error "'%s/external.desc': does not define the name\n" "${br2_ext}"
  88     fi
  89     # Only ASCII chars in [A-Za-z0-9_] are permitted
  90     n="$(sed -r -e 's/[A-Za-z0-9_]//g' <<<"${br2_name}" )"
  91     if [ -n "${n}" ]; then
  92         # Escape '$' so that it gets printed
  93         error "'%s': name '%s' contains invalid chars: '%s'\n" \
  94             "${br2_ext}" "${br2_name//\$/\$\$}" "${n//\$/\$\$}"
  95     fi
  96     eval d="\"\${BR2_EXT_PATHS_${br2_name}}\""
  97     if [ -n "${d}" ]; then
  98         error "'%s': name '%s' is already used in '%s'\n" \
  99             "${br2_ext}" "${br2_name}" "${d}"
 100     fi
 101     br2_desc="$(sed -r -e '/^desc: +(.*)$/!d; s//\1/' "${br2_ext}/external.desc")"
 102     if [ ! -f "${br2_ext}/external.mk" ]; then
 103         error "'%s/external.mk': no such file or directory\n" "${br2_ext}"
 104     fi
 105     if [ ! -f "${br2_ext}/Config.in" ]; then
 106         error "'%s/Config.in': no such file or directory\n" "${br2_ext}"
 107     fi
 108
 109     # Register this br2-external tree
 110     BR2_EXT_NAMES+=( "${br2_name}" )
 111     eval BR2_EXT_PATHS_${br2_name}="\"\${br2_ext}\""
 112     eval BR2_EXT_DESCS_${br2_name}="\"\${br2_desc:-\${br2_name}}\""
 113 }
 114
 115 # Generate the .mk snippet that defines makefile variables
 116 # for the br2-external tree
 117 do_mk() {
 118     local br2_name br2_ext
 119
 120     printf '#\n# Automatically generated file; DO NOT EDIT.\n#\n'
 121     printf '\n'
 122
 123     printf 'BR2_EXTERNAL ?='
 124     for br2_name in "${BR2_EXT_NAMES[@]}"; do
 125         eval br2_ext="\"\${BR2_EXT_PATHS_${br2_name}}\""
 126         printf ' %s' "${br2_ext}"
 127     done
 128     printf '\n'
 129
 130     printf 'BR2_EXTERNAL_NAMES = \n'
 131     printf 'BR2_EXTERNAL_DIRS = \n'
 132     printf 'BR2_EXTERNAL_MKS = \n'
 133
 134     if [ ${#BR2_EXT_NAMES[@]} -eq 0 ]; then
 135         printf '\n'
 136         printf '# No br2-external tree defined.\n'
 137         return
 138     fi
 139
 140     for br2_name in "${BR2_EXT_NAMES[@]}"; do
 141         eval br2_desc="\"\${BR2_EXT_DESCS_${br2_name}}\""
 142         eval br2_ext="\"\${BR2_EXT_PATHS_${br2_name}}\""
 143         printf '\n'
 144         printf 'BR2_EXTERNAL_NAMES += %s\n' "${br2_name}"
 145         printf 'BR2_EXTERNAL_DIRS += %s\n' "${br2_ext}"
 146         printf 'BR2_EXTERNAL_MKS += %s/external.mk\n' "${br2_ext}"
 147         printf 'export BR2_EXTERNAL_%s_PATH = %s\n' "${br2_name}" "${br2_ext}"
 148         printf 'export BR2_EXTERNAL_%s_DESC = %s\n' "${br2_name}" "${br2_desc}"
 149     done
 150 }
 151
 152 # Generate the kconfig snippet for the br2-external tree.
 153 do_kconfig() {
 154     local br2_name br2_ext
 155
 156     printf '#\n# Automatically generated file; DO NOT EDIT.\n#\n'
 157     printf '\n'
 158
 159     if [ ${#BR2_EXT_NAMES[@]} -eq 0 ]; then
 160         printf '# No br2-external tree defined.\n'
 161         return
 162     fi
 163
 164     printf 'menu "External options"\n'
 165     printf '\n'
 166
 167     for br2_name in "${BR2_EXT_NAMES[@]}"; do
 168         eval br2_desc="\"\${BR2_EXT_DESCS_${br2_name}}\""
 169         eval br2_ext="\"\${BR2_EXT_PATHS_${br2_name}}\""
 170         if [ ${#BR2_EXT_NAMES[@]} -gt 1 ]; then
 171             printf 'menu "%s"\n' "${br2_desc}"
 172         fi
 173         printf 'comment "%s (in %s)"\n' "${br2_desc}" "${br2_ext}"
 174         printf 'config BR2_EXTERNAL_%s_PATH\n' "${br2_name}"
 175         printf '\tstring\n'
 176         printf '\tdefault "%s"\n' "${br2_ext}"
 177         printf 'source "%s/Config.in"\n' "${br2_ext}"
 178         if [ ${#BR2_EXT_NAMES[@]} -gt 1 ]; then
 179             printf 'endmenu # %s\n' "${br2_name}"
 180         fi
 181         printf '\n'
 182     done
 183
 184     printf "endmenu # User-provided options\n"
 185 }
 186
 187 help() {
 188     cat <<-_EOF_
 189         Usage:
 190             ${my_name} <-m|-k> -o FILE PATH
 191
 192         With -m, ${my_name} generates the makefile fragment that defines
 193         variables related to the br2-external trees passed as positional
 194         arguments.
 195
 196         With -k, ${my_name} generates the kconfig snippet to include the
 197         configuration options specified in the br2-external trees passed
 198         as positional arguments.
 199
 200         Using -k and -m together is not possible. The last one wins.
 201
 202         Options:
 203             -m  Generate the makefile fragment.
 204
 205             -k  Generate the kconfig snippet.
 206
 207             -o FILE
 208                 FILE in which to generate the kconfig snippet or makefile
 209                 fragment.
 210
 211         Returns:
 212             0   If no error
 213             !0  If any error
 214         _EOF_
 215 }
 216
 217 error() { local fmt="${1}"; shift; printf "BR2_EXTERNAL_ERROR = ${fmt}" "${@}"; exit 1; }
 218
 219 my_name="${0##*/}"
 220 main "${@}"