blob: 793ce97c37542951bfb802ad0aee2fc26330e5f2 [file] [log] [blame]
Alex Deymoaea4c1c2015-08-19 20:24:43 -07001//
2// Copyright (C) 2013 The Android Open Source Project
3//
4// Licensed under the Apache License, Version 2.0 (the "License");
5// you may not use this file except in compliance with the License.
6// You may obtain a copy of the License at
7//
8// http://www.apache.org/licenses/LICENSE-2.0
9//
10// Unless required by applicable law or agreed to in writing, software
11// distributed under the License is distributed on an "AS IS" BASIS,
12// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13// See the License for the specific language governing permissions and
14// limitations under the License.
15//
Jay Srinivasan1c0fe792013-03-28 16:45:25 -070016
Alex Deymo39910dc2015-11-09 17:04:30 -080017#include "update_engine/common/constants.h"
Jay Srinivasan1c0fe792013-03-28 16:45:25 -070018
19namespace chromeos_update_engine {
20
Andrewa8d7df32020-03-15 20:10:01 -070021// TODO(andrewlassalle): Move this to the prefs directory.
Andrewe045aef2020-01-08 16:29:22 -080022const char kDlcMetadataRootpath[] = "/var/lib/dlc/";
23
Alex Deymodd132f32015-09-14 19:12:07 -070024const char kPowerwashSafePrefsSubDirectory[] = "update_engine/prefs";
Chris Sosaaa18e162013-06-20 13:20:30 -070025
Alex Deymodd132f32015-09-14 19:12:07 -070026const char kPrefsSubDirectory[] = "prefs";
Chris Sosaaa18e162013-06-20 13:20:30 -070027
28const char kStatefulPartition[] = "/mnt/stateful_partition";
Jay Srinivasan1c0fe792013-03-28 16:45:25 -070029
Alex Deymo390efed2016-02-18 11:00:40 -080030const char kPostinstallDefaultScript[] = "postinst";
31
Jay Srinivasand29695d2013-04-08 15:08:05 -070032// Constants defining keys for the persisted state of update engine.
David Zeuthen4e1d1492014-04-25 13:12:27 -070033const char kPrefsAttemptInProgress[] = "attempt-in-progress";
Jay Srinivasand29695d2013-04-08 15:08:05 -070034const char kPrefsBackoffExpiryTime[] = "backoff-expiry-time";
Alex Deymodd132f32015-09-14 19:12:07 -070035const char kPrefsBootId[] = "boot-id";
Jay Srinivasan19409b72013-04-12 19:23:36 -070036const char kPrefsCurrentBytesDownloaded[] = "current-bytes-downloaded";
Jay Srinivasand29695d2013-04-08 15:08:05 -070037const char kPrefsCurrentResponseSignature[] = "current-response-signature";
38const char kPrefsCurrentUrlFailureCount[] = "current-url-failure-count";
39const char kPrefsCurrentUrlIndex[] = "current-url-index";
David Zeuthen985b1122013-10-09 12:13:15 -070040const char kPrefsDailyMetricsLastReportedAt[] =
41 "daily-metrics-last-reported-at";
Jay Srinivasand29695d2013-04-08 15:08:05 -070042const char kPrefsDeltaUpdateFailures[] = "delta-update-failures";
Tao Bao3406c772019-01-02 15:34:35 -080043const char kPrefsDynamicPartitionMetadataUpdated[] =
44 "dynamic-partition-metadata-updated";
Alex Deymo820cc702013-06-28 15:43:46 -070045const char kPrefsFullPayloadAttemptNumber[] = "full-payload-attempt-number";
David Zeuthen639aa362014-02-03 16:23:44 -080046const char kPrefsInstallDateDays[] = "install-date-days";
Jay Srinivasand29695d2013-04-08 15:08:05 -070047const char kPrefsLastActivePingDay[] = "last-active-ping-day";
48const char kPrefsLastRollCallPingDay[] = "last-roll-call-ping-day";
49const char kPrefsManifestMetadataSize[] = "manifest-metadata-size";
Alex Deymof25eb492016-02-26 00:20:08 -080050const char kPrefsManifestSignatureSize[] = "manifest-signature-size";
David Zeuthen33bae492014-02-25 16:16:18 -080051const char kPrefsMetricsAttemptLastReportingTime[] =
52 "metrics-attempt-last-reporting-time";
53const char kPrefsMetricsCheckLastReportingTime[] =
54 "metrics-check-last-reporting-time";
Amin Hassaniffb6d802018-03-30 11:43:57 -070055const char kPrefsNoIgnoreBackoff[] = "no-ignore-backoff";
Chris Sosabe45bef2013-04-09 18:25:12 -070056const char kPrefsNumReboots[] = "num-reboots";
David Zeuthena573d6f2013-06-14 16:13:36 -070057const char kPrefsNumResponsesSeen[] = "num-responses-seen";
Alex Deymo8e18f932015-03-27 16:16:59 -070058const char kPrefsOmahaCohort[] = "omaha-cohort";
59const char kPrefsOmahaCohortHint[] = "omaha-cohort-hint";
60const char kPrefsOmahaCohortName[] = "omaha-cohort-name";
Jae Hoon Kim051627a2019-09-03 12:56:32 -070061const char kPrefsOmahaEolDate[] = "omaha-eol-date";
David Zeuthen27a48bc2013-08-06 12:06:29 -070062const char kPrefsP2PEnabled[] = "p2p-enabled";
David Zeuthen639aa362014-02-03 16:23:44 -080063const char kPrefsP2PFirstAttemptTimestamp[] = "p2p-first-attempt-timestamp";
64const char kPrefsP2PNumAttempts[] = "p2p-num-attempts";
Jay Srinivasand29695d2013-04-08 15:08:05 -070065const char kPrefsPayloadAttemptNumber[] = "payload-attempt-number";
Andrewe045aef2020-01-08 16:29:22 -080066// Keep |kPrefsPingActive| in sync with |kDlcMetadataFilePingActive| in
67// dlcservice.
68const char kPrefsPingActive[] = "active";
69const char kPrefsPingLastActive[] = "date_last_active";
70const char kPrefsPingLastRollcall[] = "date_last_rollcall";
Sen Jiang02c49422017-10-31 15:14:11 -070071const char kPrefsPostInstallSucceeded[] = "post-install-succeeded";
Jay Srinivasand29695d2013-04-08 15:08:05 -070072const char kPrefsPreviousVersion[] = "previous-version";
73const char kPrefsResumedUpdateFailures[] = "resumed-update-failures";
Marton Hunyadye58bddb2018-04-10 20:27:26 +020074const char kPrefsRollbackHappened[] = "rollback-happened";
Chris Sosaaa18e162013-06-20 13:20:30 -070075const char kPrefsRollbackVersion[] = "rollback-version";
Alex Deymo85616652015-10-15 18:48:31 -070076const char kPrefsChannelOnSlotPrefix[] = "channel-on-slot-";
David Zeuthene4c58bf2013-06-18 17:26:50 -070077const char kPrefsSystemUpdatedMarker[] = "system-updated-marker";
Alex Deymo42432912013-07-12 20:21:15 -070078const char kPrefsTargetVersionAttempt[] = "target-version-attempt";
79const char kPrefsTargetVersionInstalledFrom[] = "target-version-installed-from";
80const char kPrefsTargetVersionUniqueId[] = "target-version-unique-id";
Jay Srinivasan19409b72013-04-12 19:23:36 -070081const char kPrefsTotalBytesDownloaded[] = "total-bytes-downloaded";
Jay Srinivasand29695d2013-04-08 15:08:05 -070082const char kPrefsUpdateCheckCount[] = "update-check-count";
83const char kPrefsUpdateCheckResponseHash[] = "update-check-response-hash";
Alex Deymo906191f2015-10-12 12:22:44 -070084const char kPrefsUpdateCompletedBootTime[] = "update-completed-boot-time";
85const char kPrefsUpdateCompletedOnBootId[] = "update-completed-on-boot-id";
David Zeuthencc6f9962013-04-18 11:57:24 -070086const char kPrefsUpdateDurationUptime[] = "update-duration-uptime";
Jay Srinivasand29695d2013-04-08 15:08:05 -070087const char kPrefsUpdateFirstSeenAt[] = "update-first-seen-at";
Alex Deymof4867c42013-06-28 14:41:39 -070088const char kPrefsUpdateOverCellularPermission[] =
89 "update-over-cellular-permission";
Weidong Guo421ff332017-04-17 10:08:38 -070090const char kPrefsUpdateOverCellularTargetVersion[] =
91 "update-over-cellular-target-version";
92const char kPrefsUpdateOverCellularTargetSize[] =
93 "update-over-cellular-target-size";
Jay Srinivasand29695d2013-04-08 15:08:05 -070094const char kPrefsUpdateServerCertificate[] = "update-server-cert";
David Zeuthen41996ad2013-09-24 15:43:24 -070095const char kPrefsUpdateStateNextDataLength[] = "update-state-next-data-length";
David Zeuthen639aa362014-02-03 16:23:44 -080096const char kPrefsUpdateStateNextDataOffset[] = "update-state-next-data-offset";
Jay Srinivasand29695d2013-04-08 15:08:05 -070097const char kPrefsUpdateStateNextOperation[] = "update-state-next-operation";
Sen Jiang0affc2c2017-02-10 15:55:05 -080098const char kPrefsUpdateStatePayloadIndex[] = "update-state-payload-index";
Jay Srinivasand29695d2013-04-08 15:08:05 -070099const char kPrefsUpdateStateSHA256Context[] = "update-state-sha-256-context";
100const char kPrefsUpdateStateSignatureBlob[] = "update-state-signature-blob";
101const char kPrefsUpdateStateSignedSHA256Context[] =
102 "update-state-signed-sha-256-context";
Tianjie Xu2a0ea632018-08-06 12:59:23 -0700103const char kPrefsUpdateBootTimestampStart[] = "update-boot-timestamp-start";
David Zeuthen9a017f22013-04-11 16:10:26 -0700104const char kPrefsUpdateTimestampStart[] = "update-timestamp-start";
David Zeuthencc6f9962013-04-18 11:57:24 -0700105const char kPrefsUrlSwitchCount[] = "url-switch-count";
Sen Jiang3eeaf7d2018-10-11 13:55:32 -0700106const char kPrefsVerityWritten[] = "verity-written";
Adolfo Victoriad3a1e352018-07-16 11:40:47 -0700107const char kPrefsWallClockScatteringWaitPeriod[] = "wall-clock-wait-period";
108const char kPrefsWallClockStagingWaitPeriod[] =
109 "wall-clock-staging-wait-period";
Jay Srinivasand29695d2013-04-08 15:08:05 -0700110
Elliott Hughesb1e3e3c2017-02-28 15:15:38 -0800111// These four fields are generated by scripts/brillo_update_payload.
Alex Deymo98e691c2016-02-04 21:05:45 -0800112const char kPayloadPropertyFileSize[] = "FILE_SIZE";
113const char kPayloadPropertyFileHash[] = "FILE_HASH";
114const char kPayloadPropertyMetadataSize[] = "METADATA_SIZE";
115const char kPayloadPropertyMetadataHash[] = "METADATA_HASH";
Elliott Hughesb1e3e3c2017-02-28 15:15:38 -0800116// The Authorization: HTTP header to be sent when downloading the payload.
Alex Deymofdd6dec2016-03-03 22:35:43 -0800117const char kPayloadPropertyAuthorization[] = "AUTHORIZATION";
Elliott Hughesb1e3e3c2017-02-28 15:15:38 -0800118// The User-Agent HTTP header to be sent when downloading the payload.
Alex Deymofdd6dec2016-03-03 22:35:43 -0800119const char kPayloadPropertyUserAgent[] = "USER_AGENT";
Elliott Hughesb1e3e3c2017-02-28 15:15:38 -0800120// Set "POWERWASH=1" to powerwash (factory data reset) the device after
121// applying the update.
Alex Deymofb905d92016-06-03 19:26:58 -0700122const char kPayloadPropertyPowerwash[] = "POWERWASH";
Elliott Hughesb1e3e3c2017-02-28 15:15:38 -0800123// The network id to pass to android_setprocnetwork before downloading.
124// This can be used to zero-rate OTA traffic by sending it over the correct
125// network.
Alex Deymo87792ea2016-07-25 15:40:36 -0700126const char kPayloadPropertyNetworkId[] = "NETWORK_ID";
Sen Jiang02c49422017-10-31 15:14:11 -0700127// Set "SWITCH_SLOT_ON_REBOOT=0" to skip marking the updated partitions active.
128// The default is 1 (always switch slot if update succeeded).
129const char kPayloadPropertySwitchSlotOnReboot[] = "SWITCH_SLOT_ON_REBOOT";
130// Set "RUN_POST_INSTALL=0" to skip running post install, this will only be
131// honored if we're resuming an update and post install has already succeeded.
132// The default is 1 (always run post install).
133const char kPayloadPropertyRunPostInstall[] = "RUN_POST_INSTALL";
Alex Deymo98e691c2016-02-04 21:05:45 -0800134
Amin Hassani7fca2862019-03-28 16:09:22 -0700135const char kOmahaUpdaterVersion[] = "0.1.0.0";
136
Jae Hoon Kim0ae8fe12019-06-26 14:32:50 -0700137// X-Goog-Update headers.
138const char kXGoogleUpdateInteractivity[] = "X-Goog-Update-Interactivity";
139const char kXGoogleUpdateAppId[] = "X-Goog-Update-AppId";
140const char kXGoogleUpdateUpdater[] = "X-Goog-Update-Updater";
141const char kXGoogleUpdateSessionId[] = "X-Goog-SessionId";
142
Alex Vakulenkod2779df2014-06-16 13:19:00 -0700143} // namespace chromeos_update_engine