Linux Audio

Check our new training course

Embedded Linux Audio

Check our new training course
with Creative Commons CC-BY-SA
lecture materials

Bootlin logo

Elixir Cross Referencer

Loading...
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
# SPDX-FileCopyrightText: 2013 Stefano Babic <stefano.babic@swupdate.org>
#
# SPDX-License-Identifier: GPL-2.0-only

#
# For a description of the syntax of this configuration file,
# see scripts/kbuild/config-language.txt.
#

mainmenu "SWUpdate Configuration"

config CONFIG_HAVE_LINUX
	bool
	option env="HAVE_LINUX"

config CONFIG_HAVE_FREEBSD
	bool
	option env="HAVE_FREEBSD"

config CONFIG_HAVE_LUA
	bool
	option env="HAVE_LUA"

config CONFIG_HAVE_LIBCONFIG
	bool
	option env="HAVE_LIBCONFIG"

config CONFIG_HAVE_LIBARCHIVE
	bool
	option env="HAVE_LIBARCHIVE"

config CONFIG_HAVE_LIBCURL
	bool
	option env="HAVE_LIBCURL"

config CONFIG_HAVE_LIBFDISK
	bool
	option env="HAVE_LIBFDISK"

config CONFIG_HAVE_LIBBLKID
	bool
	option env="HAVE_LIBBLKID"

config CONFIG_HAVE_LIBGPIOD
	bool
	option env="HAVE_LIBGPIOD"

config CONFIG_HAVE_LIBMTD
	bool
	option env="HAVE_LIBMTD"

config CONFIG_HAVE_LIBUBI
	bool
	option env="HAVE_LIBUBI"

config CONFIG_HAVE_LIBUBOOTENV
	bool
	option env="HAVE_LIBUBOOTENV"

config CONFIG_HAVE_LIBEBGENV
       bool
       option env="HAVE_LIBEBGENV"

config CONFIG_HAVE_LIBTEGRABOOT_TOOLS
       bool
       option env="HAVE_LIBTEGRABOOT_TOOLS"

config CONFIG_HAVE_LIBEXT2FS
	bool
	option env="HAVE_LIBEXT2FS"

config CONFIG_HAVE_LIBBTRFS
	bool
	option env="HAVE_LIBBTRFS"

config CONFIG_HAVE_LIBZEROMQ
	bool
	option env="HAVE_LIBZEROMQ"

config CONFIG_HAVE_ZLIB
	bool
	option env="HAVE_ZLIB"

config CONFIG_HAVE_ZSTD
	bool
	option env="HAVE_ZSTD"

config CONFIG_HAVE_LIBSSL
	bool
	option env="HAVE_LIBSSL"

config CONFIG_HAVE_LIBSYSTEMD
	bool
	option env="HAVE_LIBSYSTEMD"

config CONFIG_HAVE_LIBCRYPTO
	bool
	option env="HAVE_LIBCRYPTO"

config CONFIG_HAVE_WOLFSSL
	bool
	option env="HAVE_WOLFSSL"

config CONFIG_HAVE_MBEDTLS
	bool
	option env="HAVE_MBEDTLS"

config CONFIG_HAVE_P11KIT
	bool
	option env="HAVE_P11KIT"

config CONFIG_HAVE_LIBWEBSOCKETS
	bool
	option env="HAVE_LIBWEBSOCKETS"

config CONFIG_HAVE_LIBRSYNC
	bool
	option env="HAVE_LIBRSYNC"

config CONFIG_HAVE_URIPARSER
	bool
	option env="HAVE_URIPARSER"

config CONFIG_HAVE_ZCK
	bool
	option env="HAVE_ZCK"

menu "SWUpdate Settings"

menu "General Configuration"

config CONFIG_CURL
	bool
	default n

config CONFIG_CURL_SSL
	bool
	default n

config CONFIG_DISKFORMAT
	bool
	default n

config CONFIG_SYSTEMD
	bool "enable systemd support"
	depends on CONFIG_HAVE_LINUX
	depends on CONFIG_HAVE_LIBSYSTEMD
	default n
	help
	  Enable support for systemd's start-up completion
	  notification and socket-based activation features.

comment "systemd support needs libsystemd"
	depends on !CONFIG_HAVE_LIBSYSTEMD && CONFIG_HAVE_LINUX

config CONFIG_DEFAULT_CONFIG_FILE
	string "File with default settings"
	default "/etc/swupdate.cfg"
	help
	  SWUpdate may get its default configuration settings
	  from the specified file (if present). Users may
	  override the default configuration with the -f
	  option switch.

config CONFIG_SCRIPTS
	bool "enable pre and postinstall scripts"
	default y
	help
	  Enabling this option, the installer will run
	  pre- and postinstall scripts, if they are present
	  in the image. For security reason, this option
	  can be switched off.

config CONFIG_HW_COMPATIBILITY
	bool "check for hardware / software compatibility"
	default n
	help
	  If enabled, check if the hardware revision
	  supports the software version. Detecting the hardware
	  revision is very board specific, and it cannot be generalized.
	  For this reason, the software expects that the detected
	  version is written into a file by a previous software.

config CONFIG_HW_COMPATIBILITY_FILE
	string "File with detected hardware revisions"
	depends on CONFIG_HW_COMPATIBILITY
	default "/etc/hwrevision"
	help
	  File where to read the detected hardware revsion
	  that must be compared with the software version.
	  The file has simple entries (one per line) in the
	  format of "major.minor".

config CONFIG_SW_VERSIONS_FILE
	string "File with detected software version"
	default "/etc/sw-versions"
	help
	  This is an optional file that is scanned at the
	  beginning to read the installed versions of
	  all sw-components. Each entry in the file is
	  a pair of "name version".
	  In sw-description,  an image can have the
	  optional attributes:
		"name" : key for searching in CONFIG_SW_VERSIONS_FILE
		"version" : version contained in the .swu
		"install-if-different" : if set, the version
			is compared with the one in CONFIG_SW_VERSIONS_FILE.
	  The image is installed only if there is a version mismatch.
	  This reduces the risk in case of components that are not
	  safe to update, such as the bootloader. Updating it is a risk,
	  but in some cases it is required to do it. Having a check,
	  the risky-component is not always updated.

menu "Socket Paths"

config CONFIG_SOCKET_CTRL_PATH
	string "SWUpdate control socket path"
	help
	  Path to SWUpdate's IPC socket.

config CONFIG_SOCKET_PROGRESS_PATH
	string "SWUpdate progress socket path"
	help
	  Path to the socket progress information is sent to.

endmenu

config CONFIG_MTD
	bool "MTD support"
	default y
	depends on CONFIG_HAVE_LINUX
	depends on CONFIG_HAVE_LIBMTD
	help
	  Enable CONFIG_MTD support.

comment "MTD support needs libmtd"
	depends on !CONFIG_HAVE_LIBMTD && CONFIG_HAVE_LINUX

config CONFIG_LUA
	bool "lua"
	default y
	depends on CONFIG_HAVE_LUA
	help
	  Enable Lua interpreter.

comment "Lua support needs a Lua interpreter"
	depends on !CONFIG_HAVE_LUA

config CONFIG_LUAPKG
	string "Lua pkg-config name"
	default "lua"
	depends on CONFIG_LUA
	help
	  Which pkg-config package supplies the Lua API.

# These are auto-selected by other options

config CONFIG_FEATURE_SYSLOG
	bool #No description makes it a hidden option
	default n
	#help
	#  This option is auto-selected when you select any applet which may
	#  send its output to syslog. You do not need to select it manually.

endmenu

menu 'Build Options'

config CONFIG_CROSS_COMPILE
	string "Cross Compiler prefix"
	default ""
	help
	  If you want to build swupdate with a cross compiler, then you
	  will need to set this to the cross-compiler prefix, for example,
	  "i386-uclibc-".

	  Native builds leave this empty.

config CONFIG_SYSROOT
	string "Path to sysroot"
	default ""
	help
	  If you want to build swupdate with a cross compiler, then you
	  might also need to specify where /usr/include and /usr/lib
	  will be found.

	  For example, swupdate can be built against an installed
	  Android NDK, platform version 9, for ARM ABI with

	  CONFIG_SYSROOT=/opt/android-ndk/platforms/android-9/arch-arm

	  Native builds leave this empty.

config CONFIG_EXTRA_CFLAGS
	string "Additional CFLAGS"
	default ""
	help
	  Additional CFLAGS to pass to the compiler verbatim.

config CONFIG_EXTRA_LDFLAGS
	string "Additional LDFLAGS"
	default ""
	help
	  Additional LDFLAGS to pass to the linker verbatim.

config CONFIG_EXTRA_LDLIBS
	string "Additional LDLIBS"
	default ""
	help
	  Additional LDLIBS to pass to the linker with -l.

endmenu

menu 'Debugging Options'

config CONFIG_DEBUG
	bool "Build SWUpdate with extra Debugging symbols"
	default n
	help
	  Say Y here if you wish to examine swupdate internals while applets are
	  running. This increases the size of the binary considerably, and
	  should only be used when doing development. If you are doing
	  development and want to debug swupdate, answer Y.

	  Most people should answer N.

config CONFIG_DEBUG_PESSIMIZE
	bool "Disable compiler optimizations"
	default n
	depends on CONFIG_DEBUG
	help
	  The compiler's optimization of source code can eliminate and reorder
	  code, resulting in an executable that's hard to understand when
	  stepping through it with a debugger. This switches it off, resulting
	  in a much bigger executable that more closely matches the source
	  code.

config CONFIG_WERROR
	bool "Abort compilation on any warning"
	default n
	help
	  Selecting this will add -Werror to gcc command line.

	  Most people should answer N.

config CONFIG_NOCLEANUP
	bool "Do not remove temporary files after execution"
	default n
	help
	  After each run, temporary files are removed from the directory
	  pointed to by the environment variable TMPDIR (/tmp as fallback
	  if unset) to restart in a clean state. For debugging purposes, it
	  helps to check the consistency of the files extracted by SWUpdate.
	  For production, answer N.

endmenu

endmenu

comment "Bootloader support"

source bootloader/Config.in


comment Interfaces

config CONFIG_DOWNLOAD
	bool "Enable image downloading"
	default n
	depends on CONFIG_HAVE_LIBCURL
	select CONFIG_CHANNEL_CURL
	select JSON
	help
	  Enable update from image URL using libcurl. The stream is sent via IPC
	  to the installer as it is done for other interfaces.

comment "Image downloading support needs libcurl"
	depends on !CONFIG_HAVE_LIBCURL

config CONFIG_DOWNLOAD_SSL
	bool "Enable SSL support for image downloading"
	default n
	depends on CONFIG_DOWNLOAD
	select CONFIG_CHANNEL_CURL_SSL
	help
	  Enable SSL support in channels using libcurl.

config CONFIG_CHANNEL_CURL
	bool
	depends on CONFIG_HAVE_LIBCURL
	select CONFIG_CURL

source suricatta/Config.in

source mongoose/Config.in

comment Security

choice
	prompt "SSL implementation to use"
	default CONFIG_SSL_IMPL_OPENSSL
	help
	  Select SSL implementation for hashing, verifying and decrypting images.

	config CONFIG_SSL_IMPL_NONE
		bool "None"

	config CONFIG_SSL_IMPL_OPENSSL
		bool "OpenSSL"
		depends on CONFIG_HAVE_LIBSSL

	config CONFIG_SSL_IMPL_WOLFSSL
		bool "wolfSSL (with OpenSSL compatibility layer)"
		depends on CONFIG_HAVE_WOLFSSL
		select CONFIG_CMS_IGNORE_CERTIFICATE_PURPOSE if CONFIG_SIGALG_CMS
		select CONFIG_CMS_SKIP_UNKNOWN_SIGNERS if CONFIG_SIGALG_CMS

	config CONFIG_SSL_IMPL_MBEDTLS
		bool "mbedTLS"
		depends on CONFIG_HAVE_MBEDTLS
endchoice


config CONFIG_CHANNEL_CURL_SSL
	bool
	depends on CONFIG_CHANNEL_CURL
	select CONFIG_CURL_SSL

config CONFIG_HASH_VERIFY
	bool "Allow to add sha256 hash to each image"
	depends on CONFIG_SSL_IMPL_OPENSSL || CONFIG_SSL_IMPL_WOLFSSL || CONFIG_SSL_IMPL_MBEDTLS
	help
	  Allow to add a sha256 hash to an artifact.
	  This is automatically set in case of Signed Image

comment "Hash checking needs an SSL implementation"
	depends on !CONFIG_SSL_IMPL_OPENSSL && !CONFIG_SSL_IMPL_WOLFSSL && !CONFIG_SSL_IMPL_MBEDTLS

config CONFIG_SIGNED_IMAGES
	bool "Enable verification of signed images"
	depends on CONFIG_SSL_IMPL_OPENSSL || CONFIG_SSL_IMPL_WOLFSSL || CONFIG_SSL_IMPL_MBEDTLS
	select CONFIG_HASH_VERIFY
comment "Image signature verification needs an SSL implementation"
	depends on !CONFIG_SSL_IMPL_OPENSSL && !CONFIG_SSL_IMPL_WOLFSSL && !CONFIG_SSL_IMPL_MBEDTLS

choice
	prompt "Signature verification algorithm"
	depends on CONFIG_SIGNED_IMAGES
	default CONFIG_SIGALG_RAWRSA
	help
	  Select if the signature algorithm for signed images is a raw RSA signature
	  (following PKCS#1.5) or if it uses Cryptographic Message Syntax (CMS) with
	  OpenSSL/LibreSSL or PKCS#7 with wolfSSL.
	  wolfSSL's PKCS#7 implementation can only deal with one signature and cannot
	  deal with X509 purposes.

	config CONFIG_SIGALG_RAWRSA
		bool "RSA PKCS#1.5"

	config CONFIG_SIGALG_RSAPSS
		bool "RSA PSS"

	config CONFIG_SIGALG_CMS
		bool "Cryptographic Message Syntax (CMS) / PKCS#7"
		depends on CONFIG_SSL_IMPL_OPENSSL || CONFIG_SSL_IMPL_WOLFSSL

	config CONFIG_SIGALG_GPG
		bool "GPG signing"
endchoice

menu "CMS / PKCS#7 signature verification options"
	depends on CONFIG_SIGALG_CMS

config CONFIG_CMS_IGNORE_EXPIRED_CERTIFICATE
	bool "Ignore expired certificates"
	depends on CONFIG_SIGALG_CMS

config CONFIG_CMS_IGNORE_CERTIFICATE_PURPOSE
	bool "Ignore X.509 certificate purpose"
	depends on CONFIG_SIGALG_CMS

config CONFIG_CMS_SKIP_UNKNOWN_SIGNERS
	bool "Ignore unverifiable signatures if known signer verifies"
	depends on CONFIG_SIGALG_CMS
endmenu


config CONFIG_ENCRYPTED_IMAGES
	bool "Images can be encrypted with a symmetric key"
	depends on CONFIG_SSL_IMPL_OPENSSL || CONFIG_SSL_IMPL_WOLFSSL || CONFIG_SSL_IMPL_MBEDTLS
comment "Image encryption needs an SSL implementation"
	depends on !CONFIG_SSL_IMPL_OPENSSL && !CONFIG_SSL_IMPL_WOLFSSL && !CONFIG_SSL_IMPL_MBEDTLS

config CONFIG_ENCRYPTED_SW_DESCRIPTION
	bool "Even sw-description is encrypted"
	depends on CONFIG_ENCRYPTED_IMAGES
	help
	  sw-description is not encrypted as default, but it is encrypted
	  if this is set. It is a compile time option, and mix of plain and
	  encrypted sw-descriptions is not possible.

config CONFIG_ENCRYPTED_IMAGES_HARDEN_LOGGING
	bool "Harden logging for encrypted images"
	default n
	depends on CONFIG_ENCRYPTED_IMAGES
	help
	  This option addresses a theoretical weakness of the AES-CBC encryption in
	  combination with streamed images. An adversary can target each 16-byte
	  block of encrypted data within an image and decrypt it, if they can apply a
	  huge amount of manipulated firmware updates and observe the logged
	  messages. On average, 2048 update attempts are needed for each block.
	  Select if this scenario poses a risk. If set, log messages related to a
	  hash mismatch and errors in the decryption finalization (padding) of a
	  streamed image are suppressed.

config CONFIG_PKCS11
	bool "Enable PKCS#11 cryptographic operations"
	default n
	depends on CONFIG_HAVE_WOLFSSL && CONFIG_HAVE_P11KIT && CONFIG_ENCRYPTED_IMAGES
	help
	  Enable using PKCS#11 for AES decryption instead of having the plain
	  key available in a file. This is implemented with wolfSSL independent
	  from the SSL implementation and replaces the plain key method.

comment "Compressors (zlib always on)"

config CONFIG_GUNZIP
	bool
	depends on CONFIG_HAVE_ZLIB
	default y

config CONFIG_ZSTD
	bool "Zstd compression support"
	depends on CONFIG_HAVE_ZSTD

comment Parsers
source parser/Config.in

comment Handlers
source handlers/Config.in

comment Containers
source containers/Config.in