1 /* SPDX-License-Identifier: LGPL-2.1+ */
5 #include <linux/loop.h>
10 #include "alloc-util.h"
11 #include "ask-password-api.h"
13 #include "dissect-image.h"
18 #include "hostname-util.h"
20 #include "libcrypt-util.h"
21 #include "locale-util.h"
22 #include "loop-util.h"
23 #include "main-func.h"
24 #include "memory-util.h"
26 #include "mount-util.h"
27 #include "namespace-util.h"
29 #include "parse-util.h"
30 #include "path-util.h"
31 #include "pretty-print.h"
32 #include "proc-cmdline.h"
33 #include "random-util.h"
34 #include "string-util.h"
36 #include "terminal-util.h"
37 #include "time-util.h"
38 #include "tmpfile-util-label.h"
39 #include "tmpfile-util.h"
40 #include "umask-util.h"
41 #include "user-util.h"
43 static char *arg_root
= NULL
;
44 static char *arg_image
= NULL
;
45 static char *arg_locale
= NULL
; /* $LANG */
46 static char *arg_keymap
= NULL
;
47 static char *arg_locale_messages
= NULL
; /* $LC_MESSAGES */
48 static char *arg_timezone
= NULL
;
49 static char *arg_hostname
= NULL
;
50 static sd_id128_t arg_machine_id
= {};
51 static char *arg_root_password
= NULL
;
52 static char *arg_root_shell
= NULL
;
53 static char *arg_kernel_cmdline
= NULL
;
54 static bool arg_prompt_locale
= false;
55 static bool arg_prompt_keymap
= false;
56 static bool arg_prompt_timezone
= false;
57 static bool arg_prompt_hostname
= false;
58 static bool arg_prompt_root_password
= false;
59 static bool arg_prompt_root_shell
= false;
60 static bool arg_copy_locale
= false;
61 static bool arg_copy_keymap
= false;
62 static bool arg_copy_timezone
= false;
63 static bool arg_copy_root_password
= false;
64 static bool arg_copy_root_shell
= false;
65 static bool arg_force
= false;
66 static bool arg_delete_root_password
= false;
67 static bool arg_root_password_is_hashed
= false;
68 static bool arg_welcome
= true;
70 STATIC_DESTRUCTOR_REGISTER(arg_root
, freep
);
71 STATIC_DESTRUCTOR_REGISTER(arg_image
, freep
);
72 STATIC_DESTRUCTOR_REGISTER(arg_locale
, freep
);
73 STATIC_DESTRUCTOR_REGISTER(arg_locale_messages
, freep
);
74 STATIC_DESTRUCTOR_REGISTER(arg_keymap
, freep
);
75 STATIC_DESTRUCTOR_REGISTER(arg_timezone
, freep
);
76 STATIC_DESTRUCTOR_REGISTER(arg_hostname
, freep
);
77 STATIC_DESTRUCTOR_REGISTER(arg_root_password
, erase_and_freep
);
79 static bool press_any_key(void) {
83 printf("-- Press any key to proceed --");
86 (void) read_one_char(stdin
, &k
, USEC_INFINITY
, &need_nl
);
94 static void print_welcome(void) {
95 _cleanup_free_
char *pretty_name
= NULL
, *ansi_color
= NULL
;
96 static bool done
= false;
106 r
= parse_os_release(
108 "PRETTY_NAME", &pretty_name
,
109 "ANSI_COLOR", &ansi_color
,
112 log_full_errno(r
== -ENOENT
? LOG_DEBUG
: LOG_WARNING
, r
,
113 "Failed to read os-release file, ignoring: %m");
115 pn
= isempty(pretty_name
) ? "Linux" : pretty_name
;
117 if (colors_enabled())
118 printf("\nWelcome to your new installation of \x1B[%sm%s\x1B[0m!\n", ansi_color
, pn
);
120 printf("\nWelcome to your new installation of %s!\n", pn
);
122 printf("\nPlease configure your system!\n\n");
129 static int show_menu(char **x
, unsigned n_columns
, unsigned width
, unsigned percentage
) {
130 unsigned break_lines
, break_modulo
;
131 size_t n
, per_column
, i
, j
;
133 assert(n_columns
> 0);
136 per_column
= DIV_ROUND_UP(n
, n_columns
);
138 break_lines
= lines();
142 /* The first page gets two extra lines, since we want to show
144 break_modulo
= break_lines
;
145 if (break_modulo
> 3)
148 for (i
= 0; i
< per_column
; i
++) {
150 for (j
= 0; j
< n_columns
; j
++) {
151 _cleanup_free_
char *e
= NULL
;
153 if (j
* per_column
+ i
>= n
)
156 e
= ellipsize(x
[j
* per_column
+ i
], width
, percentage
);
160 printf("%4zu) %-*s", j
* per_column
+ i
+ 1, width
, e
);
165 /* on the first screen we reserve 2 extra lines for the title */
166 if (i
% break_lines
== break_modulo
) {
167 if (!press_any_key())
175 static int prompt_loop(const char *text
, char **l
, unsigned percentage
, bool (*is_valid
)(const char *name
), char **ret
) {
183 _cleanup_free_
char *p
= NULL
;
186 r
= ask_string(&p
, "%s %s (empty to skip, \"list\" to list options): ",
187 special_glyph(SPECIAL_GLYPH_TRIANGULAR_BULLET
), text
);
189 return log_error_errno(r
, "Failed to query user: %m");
192 log_warning("No data entered, skipping.");
196 if (streq(p
, "list")) {
197 r
= show_menu(l
, 3, 22, percentage
);
205 r
= safe_atou(p
, &u
);
207 if (u
<= 0 || u
> strv_length(l
)) {
208 log_error("Specified entry number out of range.");
212 log_info("Selected '%s'.", l
[u
-1]);
213 if (free_and_strdup(ret
, l
[u
-1]) < 0)
220 log_error("Entered data invalid.");
224 return free_and_replace(*ret
, p
);
228 static bool locale_is_ok(const char *name
) {
231 return locale_is_valid(name
);
233 return locale_is_installed(name
) > 0;
236 static int prompt_locale(void) {
237 _cleanup_strv_free_
char **locales
= NULL
;
240 if (arg_locale
|| arg_locale_messages
)
243 if (!arg_prompt_locale
)
246 r
= get_locales(&locales
);
248 return log_error_errno(r
, "Cannot query locales list: %m");
250 if (strv_isempty(locales
))
251 log_debug("No locales found, skipping locale selection.");
252 else if (strv_length(locales
) == 1) {
254 if (streq(locales
[0], SYSTEMD_DEFAULT_LOCALE
))
255 log_debug("Only installed locale is default locale anyway, not setting locale explicitly.");
257 log_debug("Only a single locale available (%s), selecting it as default.", locales
[0]);
259 arg_locale
= strdup(locales
[0]);
263 /* Not setting arg_locale_message here, since it defaults to LANG anyway */
268 r
= prompt_loop("Please enter system locale name or number",
269 locales
, 60, locale_is_ok
, &arg_locale
);
273 if (isempty(arg_locale
))
276 r
= prompt_loop("Please enter system message locale name or number",
277 locales
, 60, locale_is_ok
, &arg_locale_messages
);
281 /* Suppress the messages setting if it's the same as the main locale anyway */
282 if (streq_ptr(arg_locale
, arg_locale_messages
))
283 arg_locale_messages
= mfree(arg_locale_messages
);
289 static int process_locale(void) {
290 const char *etc_localeconf
;
295 etc_localeconf
= prefix_roota(arg_root
, "/etc/locale.conf");
296 if (laccess(etc_localeconf
, F_OK
) >= 0 && !arg_force
)
299 if (arg_copy_locale
&& arg_root
) {
301 (void) mkdir_parents(etc_localeconf
, 0755);
302 r
= copy_file("/etc/locale.conf", etc_localeconf
, 0, 0644, 0, 0, COPY_REFLINK
);
305 return log_error_errno(r
, "Failed to copy %s: %m", etc_localeconf
);
307 log_info("%s copied.", etc_localeconf
);
316 if (!isempty(arg_locale
))
317 locales
[i
++] = strjoina("LANG=", arg_locale
);
318 if (!isempty(arg_locale_messages
) && !streq(arg_locale_messages
, arg_locale
))
319 locales
[i
++] = strjoina("LC_MESSAGES=", arg_locale_messages
);
326 (void) mkdir_parents(etc_localeconf
, 0755);
327 r
= write_env_file(etc_localeconf
, locales
);
329 return log_error_errno(r
, "Failed to write %s: %m", etc_localeconf
);
331 log_info("%s written.", etc_localeconf
);
335 static int prompt_keymap(void) {
336 _cleanup_strv_free_
char **kmaps
= NULL
;
342 if (!arg_prompt_keymap
)
345 r
= get_keymaps(&kmaps
);
346 if (r
== -ENOENT
) /* no keymaps installed */
349 return log_error_errno(r
, "Failed to read keymaps: %m");
353 return prompt_loop("Please enter system keymap name or number",
354 kmaps
, 60, keymap_is_valid
, &arg_keymap
);
357 static int process_keymap(void) {
358 const char *etc_vconsoleconf
;
362 etc_vconsoleconf
= prefix_roota(arg_root
, "/etc/vconsole.conf");
363 if (laccess(etc_vconsoleconf
, F_OK
) >= 0 && !arg_force
)
366 if (arg_copy_keymap
&& arg_root
) {
368 (void) mkdir_parents(etc_vconsoleconf
, 0755);
369 r
= copy_file("/etc/vconsole.conf", etc_vconsoleconf
, 0, 0644, 0, 0, COPY_REFLINK
);
372 return log_error_errno(r
, "Failed to copy %s: %m", etc_vconsoleconf
);
374 log_info("%s copied.", etc_vconsoleconf
);
381 return 0; /* don't fail if no keymaps are installed */
385 if (isempty(arg_keymap
))
388 keymap
= STRV_MAKE(strjoina("KEYMAP=", arg_keymap
));
390 r
= mkdir_parents(etc_vconsoleconf
, 0755);
392 return log_error_errno(r
, "Failed to create the parent directory of %s: %m", etc_vconsoleconf
);
394 r
= write_env_file(etc_vconsoleconf
, keymap
);
396 return log_error_errno(r
, "Failed to write %s: %m", etc_vconsoleconf
);
398 log_info("%s written.", etc_vconsoleconf
);
402 static bool timezone_is_valid_log_error(const char *name
) {
403 return timezone_is_valid(name
, LOG_ERR
);
406 static int prompt_timezone(void) {
407 _cleanup_strv_free_
char **zones
= NULL
;
413 if (!arg_prompt_timezone
)
416 r
= get_timezones(&zones
);
418 return log_error_errno(r
, "Cannot query timezone list: %m");
422 r
= prompt_loop("Please enter timezone name or number",
423 zones
, 30, timezone_is_valid_log_error
, &arg_timezone
);
430 static int process_timezone(void) {
431 const char *etc_localtime
, *e
;
434 etc_localtime
= prefix_roota(arg_root
, "/etc/localtime");
435 if (laccess(etc_localtime
, F_OK
) >= 0 && !arg_force
)
438 if (arg_copy_timezone
&& arg_root
) {
439 _cleanup_free_
char *p
= NULL
;
441 r
= readlink_malloc("/etc/localtime", &p
);
444 return log_error_errno(r
, "Failed to read host timezone: %m");
446 (void) mkdir_parents(etc_localtime
, 0755);
447 if (symlink(p
, etc_localtime
) < 0)
448 return log_error_errno(errno
, "Failed to create %s symlink: %m", etc_localtime
);
450 log_info("%s copied.", etc_localtime
);
455 r
= prompt_timezone();
459 if (isempty(arg_timezone
))
462 e
= strjoina("../usr/share/zoneinfo/", arg_timezone
);
464 (void) mkdir_parents(etc_localtime
, 0755);
465 if (symlink(e
, etc_localtime
) < 0)
466 return log_error_errno(errno
, "Failed to create %s symlink: %m", etc_localtime
);
468 log_info("%s written", etc_localtime
);
472 static int prompt_hostname(void) {
478 if (!arg_prompt_hostname
)
485 _cleanup_free_
char *h
= NULL
;
487 r
= ask_string(&h
, "%s Please enter hostname for new system (empty to skip): ", special_glyph(SPECIAL_GLYPH_TRIANGULAR_BULLET
));
489 return log_error_errno(r
, "Failed to query hostname: %m");
492 log_warning("No hostname entered, skipping.");
496 if (!hostname_is_valid(h
, true)) {
497 log_error("Specified hostname invalid.");
501 /* Get rid of the trailing dot that we allow, but don't want to see */
502 arg_hostname
= hostname_cleanup(h
);
510 static int process_hostname(void) {
511 const char *etc_hostname
;
514 etc_hostname
= prefix_roota(arg_root
, "/etc/hostname");
515 if (laccess(etc_hostname
, F_OK
) >= 0 && !arg_force
)
518 r
= prompt_hostname();
522 if (isempty(arg_hostname
))
525 r
= write_string_file(etc_hostname
, arg_hostname
,
526 WRITE_STRING_FILE_CREATE
| WRITE_STRING_FILE_SYNC
| WRITE_STRING_FILE_MKDIR_0755
|
527 (arg_force
? WRITE_STRING_FILE_ATOMIC
: 0));
529 return log_error_errno(r
, "Failed to write %s: %m", etc_hostname
);
531 log_info("%s written.", etc_hostname
);
535 static int process_machine_id(void) {
536 const char *etc_machine_id
;
537 char id
[SD_ID128_STRING_MAX
];
540 etc_machine_id
= prefix_roota(arg_root
, "/etc/machine-id");
541 if (laccess(etc_machine_id
, F_OK
) >= 0 && !arg_force
)
544 if (sd_id128_is_null(arg_machine_id
))
547 r
= write_string_file(etc_machine_id
, sd_id128_to_string(arg_machine_id
, id
),
548 WRITE_STRING_FILE_CREATE
| WRITE_STRING_FILE_SYNC
| WRITE_STRING_FILE_MKDIR_0755
|
549 (arg_force
? WRITE_STRING_FILE_ATOMIC
: 0));
551 return log_error_errno(r
, "Failed to write machine id: %m");
553 log_info("%s written.", etc_machine_id
);
557 static int prompt_root_password(void) {
558 const char *msg1
, *msg2
;
561 if (arg_root_password
)
564 if (!arg_prompt_root_password
)
570 msg1
= strjoina(special_glyph(SPECIAL_GLYPH_TRIANGULAR_BULLET
), " Please enter a new root password (empty to skip):");
571 msg2
= strjoina(special_glyph(SPECIAL_GLYPH_TRIANGULAR_BULLET
), " Please enter new root password again:");
574 _cleanup_strv_free_erase_
char **a
= NULL
, **b
= NULL
;
576 r
= ask_password_tty(-1, msg1
, NULL
, 0, 0, NULL
, &a
);
578 return log_error_errno(r
, "Failed to query root password: %m");
579 if (strv_length(a
) != 1)
580 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
581 "Received multiple passwords, where we expected one.");
584 log_warning("No password entered, skipping.");
588 r
= ask_password_tty(-1, msg2
, NULL
, 0, 0, NULL
, &b
);
590 return log_error_errno(r
, "Failed to query root password: %m");
591 if (strv_length(b
) != 1)
592 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
593 "Received multiple passwords, where we expected one.");
595 if (!streq(*a
, *b
)) {
596 log_error("Entered passwords did not match, please try again.");
600 arg_root_password
= TAKE_PTR(*a
);
607 static int find_shell(const char *path
, const char *root
) {
612 if (!valid_shell(path
))
613 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "%s is not a valid shell", path
);
615 r
= chase_symlinks(path
, root
, CHASE_PREFIX_ROOT
, NULL
, NULL
);
618 p
= prefix_roota(root
, path
);
619 return log_error_errno(r
, "Failed to resolve shell %s: %m", p
);
625 static int prompt_root_shell(void) {
628 if (arg_root_shell
|| !arg_prompt_root_shell
)
635 _cleanup_free_
char *s
= NULL
;
637 r
= ask_string(&s
, "%s Please enter root shell for new system (empty to skip): ", special_glyph(SPECIAL_GLYPH_TRIANGULAR_BULLET
));
639 return log_error_errno(r
, "Failed to query root shell: %m");
642 log_warning("No shell entered, skipping.");
646 r
= find_shell(s
, arg_root
);
650 arg_root_shell
= TAKE_PTR(s
);
657 static int write_root_passwd(const char *passwd_path
, const char *password
, const char *shell
) {
658 _cleanup_fclose_
FILE *original
= NULL
, *passwd
= NULL
;
659 _cleanup_(unlink_and_freep
) char *passwd_tmp
= NULL
;
664 r
= fopen_temporary_label("/etc/passwd", passwd_path
, &passwd
, &passwd_tmp
);
668 original
= fopen(passwd_path
, "re");
672 r
= sync_rights(fileno(original
), fileno(passwd
));
676 while ((r
= fgetpwent_sane(original
, &i
)) > 0) {
678 if (streq(i
->pw_name
, "root")) {
679 i
->pw_passwd
= (char *) password
;
681 i
->pw_shell
= (char *) shell
;
684 r
= putpwent_sane(i
, passwd
);
692 struct passwd root
= {
693 .pw_name
= (char *) "root",
694 .pw_passwd
= (char *) password
,
697 .pw_gecos
= (char *) "Super User",
698 .pw_dir
= (char *) "/root",
699 .pw_shell
= (char *) (shell
?: "/bin/sh"),
705 r
= fchmod(fileno(passwd
), 0644);
709 r
= putpwent_sane(&root
, passwd
);
714 r
= fflush_sync_and_check(passwd
);
718 r
= rename_and_apply_smack_floor_label(passwd_tmp
, passwd_path
);
725 static int write_root_shadow(const char *shadow_path
, const char *hashed_password
) {
726 _cleanup_fclose_
FILE *original
= NULL
, *shadow
= NULL
;
727 _cleanup_(unlink_and_freep
) char *shadow_tmp
= NULL
;
730 assert(hashed_password
);
732 r
= fopen_temporary_label("/etc/shadow", shadow_path
, &shadow
, &shadow_tmp
);
736 original
= fopen(shadow_path
, "re");
740 r
= sync_rights(fileno(original
), fileno(shadow
));
744 while ((r
= fgetspent_sane(original
, &i
)) > 0) {
746 if (streq(i
->sp_namp
, "root")) {
747 i
->sp_pwdp
= (char *) hashed_password
;
748 i
->sp_lstchg
= (long) (now(CLOCK_REALTIME
) / USEC_PER_DAY
);
751 r
= putspent_sane(i
, shadow
);
760 .sp_namp
= (char*) "root",
761 .sp_pwdp
= (char *) hashed_password
,
762 .sp_lstchg
= (long) (now(CLOCK_REALTIME
) / USEC_PER_DAY
),
768 .sp_flag
= (unsigned long) -1, /* this appears to be what everybody does ... */
774 r
= fchmod(fileno(shadow
), 0000);
778 r
= putspent_sane(&root
, shadow
);
783 r
= fflush_sync_and_check(shadow
);
787 r
= rename_and_apply_smack_floor_label(shadow_tmp
, shadow_path
);
794 static int process_root_args(void) {
795 _cleanup_close_
int lock
= -1;
796 struct crypt_data cd
= {};
797 const char *password
, *hashed_password
;
798 const char *etc_passwd
, *etc_shadow
;
801 etc_passwd
= prefix_roota(arg_root
, "/etc/passwd");
802 etc_shadow
= prefix_roota(arg_root
, "/etc/shadow");
804 /* We only mess with passwd and shadow if both do not exist or --force is specified. These files are
805 * tightly coupled and hence we make sure we have permission from the user to create/modify both
807 if ((laccess(etc_passwd
, F_OK
) >= 0 || laccess(etc_shadow
, F_OK
) >= 0) && !arg_force
)
810 (void) mkdir_parents(etc_passwd
, 0755);
812 lock
= take_etc_passwd_lock(arg_root
);
814 return log_error_errno(lock
, "Failed to take a lock on %s: %m", etc_passwd
);
816 if (arg_copy_root_shell
&& arg_root
) {
820 p
= getpwnam("root");
822 return log_error_errno(errno_or_else(EIO
), "Failed to find passwd entry for root: %m");
824 r
= free_and_strdup(&arg_root_shell
, p
->pw_shell
);
829 r
= prompt_root_shell();
833 if (arg_copy_root_password
&& arg_root
) {
837 p
= getspnam("root");
839 return log_error_errno(errno_or_else(EIO
), "Failed to find shadow entry for root: %m");
841 r
= free_and_strdup(&arg_root_password
, p
->sp_pwdp
);
845 arg_root_password_is_hashed
= true;
848 r
= prompt_root_password();
852 if (arg_root_password
&& arg_root_password_is_hashed
) {
854 hashed_password
= arg_root_password
;
855 } else if (arg_root_password
) {
856 _cleanup_free_
char *salt
= NULL
;
857 /* hashed_password points inside cd after crypt_r returns so cd has function scope. */
861 r
= make_salt(&salt
);
863 return log_error_errno(r
, "Failed to get salt: %m");
866 hashed_password
= crypt_r(arg_root_password
, salt
, &cd
);
867 if (!hashed_password
)
868 return log_error_errno(errno
== 0 ? SYNTHETIC_ERRNO(EINVAL
) : errno
,
869 "Failed to encrypt password: %m");
870 } else if (arg_delete_root_password
)
871 password
= hashed_password
= "";
873 password
= hashed_password
= "!";
875 r
= write_root_passwd(etc_passwd
, password
, arg_root_shell
);
877 return log_error_errno(r
, "Failed to write %s: %m", etc_passwd
);
879 log_info("%s written", etc_passwd
);
881 r
= write_root_shadow(etc_shadow
, hashed_password
);
883 return log_error_errno(r
, "Failed to write %s: %m", etc_shadow
);
885 log_info("%s written.", etc_shadow
);
889 static int process_kernel_cmdline(void) {
890 const char *etc_kernel_cmdline
;
893 etc_kernel_cmdline
= prefix_roota(arg_root
, "/etc/kernel/cmdline");
894 if (laccess(etc_kernel_cmdline
, F_OK
) >= 0 && !arg_force
)
897 if (!arg_kernel_cmdline
)
900 r
= write_string_file(etc_kernel_cmdline
, arg_kernel_cmdline
,
901 WRITE_STRING_FILE_CREATE
| WRITE_STRING_FILE_SYNC
| WRITE_STRING_FILE_MKDIR_0755
|
902 (arg_force
? WRITE_STRING_FILE_ATOMIC
: 0));
904 return log_error_errno(r
, "Failed to write %s: %m", etc_kernel_cmdline
);
906 log_info("%s written.", etc_kernel_cmdline
);
910 static int setup_image(char **ret_mount_dir
, LoopDevice
**ret_loop_device
, DecryptedImage
**ret_decrypted_image
) {
911 DissectImageFlags f
= DISSECT_IMAGE_REQUIRE_ROOT
|DISSECT_IMAGE_VALIDATE_OS
|DISSECT_IMAGE_RELAX_VAR_CHECK
|DISSECT_IMAGE_FSCK
;
912 _cleanup_(loop_device_unrefp
) LoopDevice
*d
= NULL
;
913 _cleanup_(decrypted_image_unrefp
) DecryptedImage
*decrypted_image
= NULL
;
914 _cleanup_(dissected_image_unrefp
) DissectedImage
*dissected_image
= NULL
;
915 _cleanup_(rmdir_and_freep
) char *mount_dir
= NULL
;
916 _cleanup_free_
char *temp
= NULL
;
920 *ret_mount_dir
= NULL
;
921 *ret_decrypted_image
= NULL
;
922 *ret_loop_device
= NULL
;
928 r
= tempfn_random_child(NULL
, "firstboot", &temp
);
930 return log_error_errno(r
, "Failed to generate temporary mount directory: %m");
932 r
= loop_device_make_by_path(arg_image
, O_RDWR
, LO_FLAGS_PARTSCAN
, &d
);
934 return log_error_errno(r
, "Failed to set up loopback device: %m");
936 r
= dissect_image_and_warn(d
->fd
, arg_image
, NULL
, 0, NULL
, f
, &dissected_image
);
940 r
= dissected_image_decrypt_interactively(dissected_image
, NULL
, NULL
, 0, NULL
, NULL
, NULL
, 0, f
, &decrypted_image
);
944 r
= detach_mount_namespace();
946 return log_error_errno(r
, "Failed to detach mount namespace: %m");
948 mount_dir
= strdup(temp
);
952 r
= mkdir_p(mount_dir
, 0700);
954 mount_dir
= mfree(mount_dir
);
955 return log_error_errno(r
, "Failed to create mount point: %m");
958 r
= dissected_image_mount(dissected_image
, mount_dir
, UID_INVALID
, f
);
960 return log_error_errno(r
, "Failed to mount image: %m");
962 if (decrypted_image
) {
963 r
= decrypted_image_relinquish(decrypted_image
);
965 return log_error_errno(r
, "Failed to relinquish DM devices: %m");
968 loop_device_relinquish(d
);
970 arg_root
= TAKE_PTR(temp
);
972 *ret_mount_dir
= TAKE_PTR(mount_dir
);
973 *ret_decrypted_image
= TAKE_PTR(decrypted_image
);
974 *ret_loop_device
= TAKE_PTR(d
);
979 static int help(void) {
980 _cleanup_free_
char *link
= NULL
;
983 r
= terminal_urlify_man("systemd-firstboot", "1", &link
);
987 printf("%s [OPTIONS...]\n\n"
988 "Configures basic settings of the system.\n\n"
989 " -h --help Show this help\n"
990 " --version Show package version\n"
991 " --root=PATH Operate on an alternate filesystem root\n"
992 " --image=PATH Operate on an alternate filesystem image\n"
993 " --locale=LOCALE Set primary locale (LANG=)\n"
994 " --locale-messages=LOCALE Set message locale (LC_MESSAGES=)\n"
995 " --keymap=KEYMAP Set keymap\n"
996 " --timezone=TIMEZONE Set timezone\n"
997 " --hostname=NAME Set hostname\n"
998 " --machine-ID=ID Set machine ID\n"
999 " --root-password=PASSWORD Set root password from plaintext password\n"
1000 " --root-password-file=FILE Set root password from file\n"
1001 " --root-password-hashed=HASHED_PASSWORD Set root password from hashed password\n"
1002 " --root-shell=SHELL Set root shell\n"
1003 " --prompt-locale Prompt the user for locale settings\n"
1004 " --prompt-keymap Prompt the user for keymap settings\n"
1005 " --prompt-timezone Prompt the user for timezone\n"
1006 " --prompt-hostname Prompt the user for hostname\n"
1007 " --prompt-root-password Prompt the user for root password\n"
1008 " --prompt-root-shell Prompt the user for root shell\n"
1009 " --prompt Prompt for all of the above\n"
1010 " --copy-locale Copy locale from host\n"
1011 " --copy-keymap Copy keymap from host\n"
1012 " --copy-timezone Copy timezone from host\n"
1013 " --copy-root-password Copy root password from host\n"
1014 " --copy-root-shell Copy root shell from host\n"
1015 " --copy Copy locale, keymap, timezone, root password\n"
1016 " --setup-machine-id Generate a new random machine ID\n"
1017 " --force Overwrite existing files\n"
1018 " --delete-root-password Delete root password\n"
1019 " --welcome=no Disable the welcome text\n"
1020 "\nSee the %s for details.\n"
1021 , program_invocation_short_name
1028 static int parse_argv(int argc
, char *argv
[]) {
1031 ARG_VERSION
= 0x100,
1035 ARG_LOCALE_MESSAGES
,
1041 ARG_ROOT_PASSWORD_FILE
,
1042 ARG_ROOT_PASSWORD_HASHED
,
1044 ARG_KERNEL_COMMAND_LINE
,
1048 ARG_PROMPT_TIMEZONE
,
1049 ARG_PROMPT_HOSTNAME
,
1050 ARG_PROMPT_ROOT_PASSWORD
,
1051 ARG_PROMPT_ROOT_SHELL
,
1056 ARG_COPY_ROOT_PASSWORD
,
1057 ARG_COPY_ROOT_SHELL
,
1058 ARG_SETUP_MACHINE_ID
,
1060 ARG_DELETE_ROOT_PASSWORD
,
1064 static const struct option options
[] = {
1065 { "help", no_argument
, NULL
, 'h' },
1066 { "version", no_argument
, NULL
, ARG_VERSION
},
1067 { "root", required_argument
, NULL
, ARG_ROOT
},
1068 { "image", required_argument
, NULL
, ARG_IMAGE
},
1069 { "locale", required_argument
, NULL
, ARG_LOCALE
},
1070 { "locale-messages", required_argument
, NULL
, ARG_LOCALE_MESSAGES
},
1071 { "keymap", required_argument
, NULL
, ARG_KEYMAP
},
1072 { "timezone", required_argument
, NULL
, ARG_TIMEZONE
},
1073 { "hostname", required_argument
, NULL
, ARG_HOSTNAME
},
1074 { "machine-id", required_argument
, NULL
, ARG_MACHINE_ID
},
1075 { "root-password", required_argument
, NULL
, ARG_ROOT_PASSWORD
},
1076 { "root-password-file", required_argument
, NULL
, ARG_ROOT_PASSWORD_FILE
},
1077 { "root-password-hashed", required_argument
, NULL
, ARG_ROOT_PASSWORD_HASHED
},
1078 { "root-shell", required_argument
, NULL
, ARG_ROOT_SHELL
},
1079 { "kernel-command-line", required_argument
, NULL
, ARG_KERNEL_COMMAND_LINE
},
1080 { "prompt", no_argument
, NULL
, ARG_PROMPT
},
1081 { "prompt-locale", no_argument
, NULL
, ARG_PROMPT_LOCALE
},
1082 { "prompt-keymap", no_argument
, NULL
, ARG_PROMPT_KEYMAP
},
1083 { "prompt-timezone", no_argument
, NULL
, ARG_PROMPT_TIMEZONE
},
1084 { "prompt-hostname", no_argument
, NULL
, ARG_PROMPT_HOSTNAME
},
1085 { "prompt-root-password", no_argument
, NULL
, ARG_PROMPT_ROOT_PASSWORD
},
1086 { "prompt-root-shell", no_argument
, NULL
, ARG_PROMPT_ROOT_SHELL
},
1087 { "copy", no_argument
, NULL
, ARG_COPY
},
1088 { "copy-locale", no_argument
, NULL
, ARG_COPY_LOCALE
},
1089 { "copy-keymap", no_argument
, NULL
, ARG_COPY_KEYMAP
},
1090 { "copy-timezone", no_argument
, NULL
, ARG_COPY_TIMEZONE
},
1091 { "copy-root-password", no_argument
, NULL
, ARG_COPY_ROOT_PASSWORD
},
1092 { "copy-root-shell", no_argument
, NULL
, ARG_COPY_ROOT_SHELL
},
1093 { "setup-machine-id", no_argument
, NULL
, ARG_SETUP_MACHINE_ID
},
1094 { "force", no_argument
, NULL
, ARG_FORCE
},
1095 { "delete-root-password", no_argument
, NULL
, ARG_DELETE_ROOT_PASSWORD
},
1096 { "welcome", required_argument
, NULL
, ARG_WELCOME
},
1105 while ((c
= getopt_long(argc
, argv
, "h", options
, NULL
)) >= 0)
1116 r
= parse_path_argument_and_warn(optarg
, true, &arg_root
);
1122 r
= parse_path_argument_and_warn(optarg
, false, &arg_image
);
1128 r
= free_and_strdup(&arg_locale
, optarg
);
1134 case ARG_LOCALE_MESSAGES
:
1135 r
= free_and_strdup(&arg_locale_messages
, optarg
);
1142 if (!keymap_is_valid(optarg
))
1143 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1144 "Keymap %s is not valid.", optarg
);
1146 r
= free_and_strdup(&arg_keymap
, optarg
);
1153 if (!timezone_is_valid(optarg
, LOG_ERR
))
1154 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1155 "Timezone %s is not valid.", optarg
);
1157 r
= free_and_strdup(&arg_timezone
, optarg
);
1163 case ARG_ROOT_PASSWORD
:
1164 r
= free_and_strdup(&arg_root_password
, optarg
);
1168 arg_root_password_is_hashed
= false;
1171 case ARG_ROOT_PASSWORD_FILE
:
1172 arg_root_password
= mfree(arg_root_password
);
1174 r
= read_one_line_file(optarg
, &arg_root_password
);
1176 return log_error_errno(r
, "Failed to read %s: %m", optarg
);
1178 arg_root_password_is_hashed
= false;
1181 case ARG_ROOT_PASSWORD_HASHED
:
1182 r
= free_and_strdup(&arg_root_password
, optarg
);
1186 arg_root_password_is_hashed
= true;
1189 case ARG_ROOT_SHELL
:
1190 r
= find_shell(optarg
, arg_root
);
1194 r
= free_and_strdup(&arg_root_shell
, optarg
);
1201 if (!hostname_is_valid(optarg
, true))
1202 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1203 "Host name %s is not valid.", optarg
);
1205 hostname_cleanup(optarg
);
1206 r
= free_and_strdup(&arg_hostname
, optarg
);
1212 case ARG_MACHINE_ID
:
1213 if (sd_id128_from_string(optarg
, &arg_machine_id
) < 0)
1214 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1215 "Failed to parse machine id %s.", optarg
);
1219 case ARG_KERNEL_COMMAND_LINE
:
1220 r
= free_and_strdup(&arg_kernel_cmdline
, optarg
);
1227 arg_prompt_locale
= arg_prompt_keymap
= arg_prompt_timezone
= arg_prompt_hostname
=
1228 arg_prompt_root_password
= arg_prompt_root_shell
= true;
1231 case ARG_PROMPT_LOCALE
:
1232 arg_prompt_locale
= true;
1235 case ARG_PROMPT_KEYMAP
:
1236 arg_prompt_keymap
= true;
1239 case ARG_PROMPT_TIMEZONE
:
1240 arg_prompt_timezone
= true;
1243 case ARG_PROMPT_HOSTNAME
:
1244 arg_prompt_hostname
= true;
1247 case ARG_PROMPT_ROOT_PASSWORD
:
1248 arg_prompt_root_password
= true;
1251 case ARG_PROMPT_ROOT_SHELL
:
1252 arg_prompt_root_shell
= true;
1256 arg_copy_locale
= arg_copy_keymap
= arg_copy_timezone
= arg_copy_root_password
=
1257 arg_copy_root_shell
= true;
1260 case ARG_COPY_LOCALE
:
1261 arg_copy_locale
= true;
1264 case ARG_COPY_KEYMAP
:
1265 arg_copy_keymap
= true;
1268 case ARG_COPY_TIMEZONE
:
1269 arg_copy_timezone
= true;
1272 case ARG_COPY_ROOT_PASSWORD
:
1273 arg_copy_root_password
= true;
1276 case ARG_COPY_ROOT_SHELL
:
1277 arg_copy_root_shell
= true;
1280 case ARG_SETUP_MACHINE_ID
:
1281 r
= sd_id128_randomize(&arg_machine_id
);
1283 return log_error_errno(r
, "Failed to generate randomized machine ID: %m");
1291 case ARG_DELETE_ROOT_PASSWORD
:
1292 arg_delete_root_password
= true;
1296 r
= parse_boolean(optarg
);
1298 return log_error_errno(r
, "Failed to parse --welcome= argument: %s", optarg
);
1307 assert_not_reached("Unhandled option");
1310 /* We check if the specified locale strings are valid down here, so that we can take --root= into
1311 * account when looking for the locale files. */
1313 if (arg_locale
&& !locale_is_ok(arg_locale
))
1314 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Locale %s is not installed.", arg_locale
);
1315 if (arg_locale_messages
&& !locale_is_ok(arg_locale_messages
))
1316 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Locale %s is not installed.", arg_locale_messages
);
1318 if (arg_delete_root_password
&& (arg_copy_root_password
|| arg_root_password
|| arg_prompt_root_password
))
1319 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1320 "--delete-root-password cannot be combined with other root password options");
1322 if (arg_image
&& arg_root
)
1323 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Please specify either --root= or --image=, the combination of both is not supported.");
1328 static int run(int argc
, char *argv
[]) {
1329 _cleanup_(loop_device_unrefp
) LoopDevice
*loop_device
= NULL
;
1330 _cleanup_(decrypted_image_unrefp
) DecryptedImage
*decrypted_image
= NULL
;
1331 _cleanup_(umount_and_rmdir_and_freep
) char *unlink_dir
= NULL
;
1334 r
= parse_argv(argc
, argv
);
1338 log_setup_service();
1342 if (!arg_root
&& !arg_image
) {
1345 /* If we are called without --root=/--image= let's honour the systemd.firstboot kernel
1346 * command line option, because we are called to provision the host with basic settings (as
1347 * opposed to some other file system tree/image) */
1349 r
= proc_cmdline_get_bool("systemd.firstboot", &enabled
);
1351 return log_error_errno(r
, "Failed to parse systemd.firstboot= kernel command line argument, ignoring: %m");
1352 if (r
> 0 && !enabled
)
1353 return 0; /* disabled */
1356 r
= setup_image(&unlink_dir
, &loop_device
, &decrypted_image
);
1360 r
= process_locale();
1364 r
= process_keymap();
1368 r
= process_timezone();
1372 r
= process_hostname();
1376 r
= process_machine_id();
1380 r
= process_root_args();
1384 r
= process_kernel_cmdline();
1391 DEFINE_MAIN_FUNCTION(run
);