base-files: sysupgrade: correct command help text
[openwrt/openwrt.git] / package / base-files / files / sbin / sysupgrade
1 #!/bin/sh
2
3 . /lib/functions.sh
4 . /lib/functions/system.sh
5
6 # initialize defaults
7 export MTD_CONFIG_ARGS=""
8 export INTERACTIVE=0
9 export VERBOSE=1
10 export SAVE_CONFIG=1
11 export SAVE_OVERLAY=0
12 export SAVE_PARTITIONS=1
13 export CONF_IMAGE=
14 export CONF_BACKUP_LIST=0
15 export CONF_BACKUP=
16 export CONF_RESTORE=
17 export NEED_IMAGE=
18 export HELP=0
19 export FORCE=0
20 export TEST=0
21
22 # parse options
23 while [ -n "$1" ]; do
24 case "$1" in
25 -i) export INTERACTIVE=1;;
26 -v) export VERBOSE="$(($VERBOSE + 1))";;
27 -q) export VERBOSE="$(($VERBOSE - 1))";;
28 -n) export SAVE_CONFIG=0;;
29 -c) export SAVE_OVERLAY=1;;
30 -p) export SAVE_PARTITIONS=0;;
31 -b|--create-backup) export CONF_BACKUP="$2" NEED_IMAGE=1; shift;;
32 -r|--restore-backup) export CONF_RESTORE="$2" NEED_IMAGE=1; shift;;
33 -l|--list-backup) export CONF_BACKUP_LIST=1; break;;
34 -f) export CONF_IMAGE="$2"; shift;;
35 -F|--force) export FORCE=1;;
36 -T|--test) export TEST=1;;
37 -h|--help) export HELP=1; break;;
38 -*)
39 echo "Invalid option: $1"
40 exit 1
41 ;;
42 *) break;;
43 esac
44 shift;
45 done
46
47 export CONFFILES=/tmp/sysupgrade.conffiles
48 export CONF_TAR=/tmp/sysupgrade.tgz
49
50 IMAGE="$1"
51
52 [ -z "$IMAGE" -a -z "$NEED_IMAGE" -o $HELP -gt 0 ] && {
53 cat <<EOF
54 Usage: $0 [<upgrade-option>...] <image file or URL>
55 $0 [-q] [-i] <backup-command> <file>
56
57 upgrade-option:
58 -f <config> restore configuration from .tar.gz (file or url)
59 -i interactive mode
60 -c attempt to preserve all changed files in /etc/
61 -n do not save configuration over reflash
62 -p do not attempt to restore the partition table after flash.
63 -T | --test
64 Verify image and config .tar.gz but do not actually flash.
65 -F | --force
66 Flash image even if image checks fail, this is dangerous!
67 -q less verbose
68 -v more verbose
69 -h | --help display this help
70
71 backup-command:
72 -b | --create-backup <file>
73 create .tar.gz of files specified in sysupgrade.conf
74 then exit. Does not flash an image. If file is '-',
75 i.e. stdout, verbosity is set to 0 (i.e. quiet).
76 -r | --restore-backup <file>
77 restore a .tar.gz created with sysupgrade -b
78 then exit. Does not flash an image. If file is '-',
79 the archive is read from stdin.
80 -l | --list-backup
81 list the files that would be backed up when calling
82 sysupgrade -b. Does not create a backup file.
83
84 EOF
85 exit 1
86 }
87
88 [ -n "$IMAGE" -a -n "$NEED_IMAGE" ] && {
89 cat <<-EOF
90 -b|--create-backup and -r|--restore-backup do not perform a firmware upgrade.
91 Do not specify both -b|-r and a firmware image.
92 EOF
93 exit 1
94 }
95
96 # prevent messages from clobbering the tarball when using stdout
97 [ "$CONF_BACKUP" = "-" ] && export VERBOSE=0
98
99 add_uci_conffiles() {
100 local file="$1"
101 ( find $(sed -ne '/^[[:space:]]*$/d; /^#/d; p' \
102 /etc/sysupgrade.conf /lib/upgrade/keep.d/* 2>/dev/null) \
103 -type f -o -type l 2>/dev/null;
104 opkg list-changed-conffiles ) | sort -u > "$file"
105 return 0
106 }
107
108 add_overlayfiles() {
109 local file="$1"
110 find /overlay/upper/etc/ -type f -o -type l | sed \
111 -e 's,^/overlay\/upper/,/,' \
112 -e '\,/META_[a-zA-Z0-9]*$,d' \
113 -e '\,/functions.sh$,d' \
114 -e '\,/[^/]*-opkg$,d' \
115 > "$file"
116 return 0
117 }
118
119 # hooks
120 sysupgrade_image_check="fwtool_check_image platform_check_image"
121 sysupgrade_pre_upgrade="fwtool_pre_upgrade"
122
123 if [ $SAVE_OVERLAY = 1 ]; then
124 [ ! -d /overlay/upper/etc ] && {
125 echo "Cannot find '/overlay/upper/etc', required for '-c'"
126 exit 1
127 }
128 sysupgrade_init_conffiles="add_overlayfiles"
129 else
130 sysupgrade_init_conffiles="add_uci_conffiles"
131 fi
132
133 include /lib/upgrade
134
135 do_save_conffiles() {
136 local conf_tar="${1:-$CONF_TAR}"
137
138 [ -z "$(rootfs_type)" ] && {
139 echo "Cannot save config while running from ramdisk."
140 ask_bool 0 "Abort" && exit
141 rm -f "$conf_tar"
142 return 0
143 }
144 run_hooks "$CONFFILES" $sysupgrade_init_conffiles
145 ask_bool 0 "Edit config file list" && vi "$CONFFILES"
146
147 v "Saving config files..."
148 [ "$VERBOSE" -gt 1 ] && TAR_V="v" || TAR_V=""
149 tar c${TAR_V}zf "$conf_tar" -T "$CONFFILES" 2>/dev/null
150
151 rm -f "$CONFFILES"
152 }
153
154 if [ $CONF_BACKUP_LIST -eq 1 ]; then
155 run_hooks "$CONFFILES" $sysupgrade_init_conffiles
156 cat "$CONFFILES"
157 rm -f "$CONFFILES"
158 exit 0
159 fi
160
161 if [ -n "$CONF_BACKUP" ]; then
162 do_save_conffiles "$CONF_BACKUP"
163 exit $?
164 fi
165
166 if [ -n "$CONF_RESTORE" ]; then
167 if [ "$CONF_RESTORE" != "-" ] && [ ! -f "$CONF_RESTORE" ]; then
168 echo "Backup archive '$CONF_RESTORE' not found."
169 exit 1
170 fi
171
172 [ "$VERBOSE" -gt 1 ] && TAR_V="v" || TAR_V=""
173 tar -C / -x${TAR_V}zf "$CONF_RESTORE"
174 exit $?
175 fi
176
177 type platform_check_image >/dev/null 2>/dev/null || {
178 echo "Firmware upgrade is not implemented for this platform."
179 exit 1
180 }
181
182 case "$IMAGE" in
183 http://*)
184 wget -O/tmp/sysupgrade.img "$IMAGE"
185 IMAGE=/tmp/sysupgrade.img
186 ;;
187 esac
188
189 IMAGE="$(readlink -f "$IMAGE")"
190
191 case "$IMAGE" in
192 '')
193 echo "Image file not found."
194 exit 1
195 ;;
196 /tmp/*) ;;
197 *)
198 v "Image not in /tmp, copying..."
199 cp -f "$IMAGE" /tmp/sysupgrade.img
200 IMAGE=/tmp/sysupgrade.img
201 ;;
202 esac
203
204 export ARGV="$IMAGE"
205 export ARGC=1
206
207 for check in $sysupgrade_image_check; do
208 ( $check "$IMAGE" ) || {
209 if [ $FORCE -eq 1 ]; then
210 echo "Image check '$check' failed but --force given - will update anyway!"
211 break
212 else
213 echo "Image check '$check' failed."
214 exit 1
215 fi
216 }
217 done
218
219 if [ -n "$CONF_IMAGE" ]; then
220 case "$(get_magic_word $CONF_IMAGE cat)" in
221 # .gz files
222 1f8b) ;;
223 *)
224 echo "Invalid config file. Please use only .tar.gz files"
225 exit 1
226 ;;
227 esac
228 get_image "$CONF_IMAGE" "cat" > "$CONF_TAR"
229 export SAVE_CONFIG=1
230 elif ask_bool $SAVE_CONFIG "Keep config files over reflash"; then
231 [ $TEST -eq 1 ] || do_save_conffiles
232 export SAVE_CONFIG=1
233 else
234 [ $TEST -eq 1 ] || rm -f "$CONF_TAR"
235 export SAVE_CONFIG=0
236 fi
237
238 if [ $TEST -eq 1 ]; then
239 exit 0
240 fi
241
242 if [ $SAVE_PARTITIONS -eq 0 ]; then
243 touch /tmp/sysupgrade.always.overwrite.bootdisk.partmap
244 else
245 rm -f /tmp/sysupgrade.always.overwrite.bootdisk.partmap
246 fi
247
248 run_hooks "" $sysupgrade_pre_upgrade
249
250 install_bin /sbin/upgraded
251 v "Commencing upgrade. All shell sessions will be closed now."
252
253 COMMAND='. /lib/functions.sh; include /lib/upgrade; do_upgrade_stage2'
254
255 if [ -n "$FAILSAFE" ]; then
256 printf '%s\x00%s\x00%s' "$RAM_ROOT" "$IMAGE" "$COMMAND" >/tmp/sysupgrade
257 lock -u /tmp/.failsafe
258 else
259 ubus call system sysupgrade "{
260 \"prefix\": $(json_string "$RAM_ROOT"),
261 \"path\": $(json_string "$IMAGE"),
262 \"command\": $(json_string "$COMMAND")
263 }"
264 fi