1 // 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 // 16 17 #ifndef UPDATE_ENGINE_COMMON_CONSTANTS_H_ 18 #define UPDATE_ENGINE_COMMON_CONSTANTS_H_ 19 20 #include <cstdint> 21 22 namespace chromeos_update_engine { 23 // The root path of all exclusion prefs. 24 static constexpr const auto& kExclusionPrefsSubDir = "exclusion"; 25 26 // The root path of all DLC metadata. 27 static constexpr const auto& kDlcPrefsSubDir = "dlc"; 28 29 // Directory for AU prefs that are preserved across powerwash. 30 static constexpr const auto& kPowerwashSafePrefsSubDirectory = 31 "update_engine/prefs"; 32 33 // The location where we store the AU preferences (state etc). 34 static constexpr const auto& kPrefsSubDirectory = "prefs"; 35 36 // Path to the stateful partition on the root filesystem. 37 static constexpr const auto& kStatefulPartition = "/mnt/stateful_partition"; 38 39 // Path to the post install command, relative to the partition. 40 static constexpr const auto& kPostinstallDefaultScript = "postinst"; 41 42 // Constants related to preferences. 43 // Constants defining keys for the persisted state of update engine. 44 static constexpr const auto& kPrefsAttemptInProgress = "attempt-in-progress"; 45 static constexpr const auto& kPrefsBackoffExpiryTime = "backoff-expiry-time"; 46 static constexpr const auto& kPrefsBootId = "boot-id"; 47 static constexpr const auto& kPrefsCurrentBytesDownloaded = 48 "current-bytes-downloaded"; 49 static constexpr const auto& kPrefsCurrentResponseSignature = 50 "current-response-signature"; 51 static constexpr const auto& kPrefsCurrentUrlFailureCount = 52 "current-url-failure-count"; 53 static constexpr const auto& kPrefsCurrentUrlIndex = "current-url-index"; 54 static constexpr const auto& kPrefsDailyMetricsLastReportedAt = 55 "daily-metrics-last-reported-at"; 56 static constexpr const auto& kPrefsDeltaUpdateFailures = 57 "delta-update-failures"; 58 static constexpr const auto& kPrefsDynamicPartitionMetadataUpdated = 59 "dynamic-partition-metadata-updated"; 60 static constexpr const auto& kPrefsFullPayloadAttemptNumber = 61 "full-payload-attempt-number"; 62 static constexpr const auto& kPrefsInstallDateDays = "install-date-days"; 63 static constexpr const auto& kPrefsLastActivePingDay = "last-active-ping-day"; 64 static constexpr const auto& kPrefsLastRollCallPingDay = 65 "last-roll-call-ping-day"; 66 static constexpr const auto& kPrefsManifestMetadataSize = 67 "manifest-metadata-size"; 68 static constexpr const auto& kPrefsManifestSignatureSize = 69 "manifest-signature-size"; 70 static constexpr const auto& kPrefsMetricsAttemptLastReportingTime = 71 "metrics-attempt-last-reporting-time"; 72 static constexpr const auto& kPrefsMetricsCheckLastReportingTime = 73 "metrics-check-last-reporting-time"; 74 static constexpr const auto& kPrefsNoIgnoreBackoff = "no-ignore-backoff"; 75 static constexpr const auto& kPrefsNumReboots = "num-reboots"; 76 static constexpr const auto& kPrefsNumResponsesSeen = "num-responses-seen"; 77 static constexpr const auto& kPrefsOmahaCohort = "omaha-cohort"; 78 static constexpr const auto& kPrefsOmahaCohortHint = "omaha-cohort-hint"; 79 static constexpr const auto& kPrefsOmahaCohortName = "omaha-cohort-name"; 80 static constexpr const auto& kPrefsOmahaEolDate = "omaha-eol-date"; 81 static constexpr const auto& kPrefsP2PEnabled = "p2p-enabled"; 82 static constexpr const auto& kPrefsP2PFirstAttemptTimestamp = 83 "p2p-first-attempt-timestamp"; 84 static constexpr const auto& kPrefsP2PNumAttempts = "p2p-num-attempts"; 85 static constexpr const auto& kPrefsPayloadAttemptNumber = 86 "payload-attempt-number"; 87 static constexpr const auto& kPrefsTestUpdateCheckIntervalTimeout = 88 "test-update-check-interval-timeout"; 89 // Keep |kPrefsPingActive| in sync with |kDlcMetadataFilePingActive| in 90 // dlcservice. 91 static constexpr const auto& kPrefsPingActive = "active"; 92 static constexpr const auto& kPrefsPingLastActive = "date_last_active"; 93 static constexpr const auto& kPrefsPingLastRollcall = "date_last_rollcall"; 94 static constexpr const auto& kPrefsLastFp = "last-fp"; 95 static constexpr const auto& kPrefsPostInstallSucceeded = 96 "post-install-succeeded"; 97 static constexpr const auto& kPrefsPreviousVersion = "previous-version"; 98 static constexpr const auto& kPrefsResumedUpdateFailures = 99 "resumed-update-failures"; 100 static constexpr const auto& kPrefsRollbackHappened = "rollback-happened"; 101 static constexpr const auto& kPrefsRollbackVersion = "rollback-version"; 102 static constexpr const auto& kPrefsChannelOnSlotPrefix = "channel-on-slot-"; 103 static constexpr const auto& kPrefsSystemUpdatedMarker = 104 "system-updated-marker"; 105 static constexpr const auto& kPrefsTargetVersionAttempt = 106 "target-version-attempt"; 107 static constexpr const auto& kPrefsTargetVersionInstalledFrom = 108 "target-version-installed-from"; 109 static constexpr const auto& kPrefsTargetVersionUniqueId = 110 "target-version-unique-id"; 111 static constexpr const auto& kPrefsTotalBytesDownloaded = 112 "total-bytes-downloaded"; 113 static constexpr const auto& kPrefsUpdateCheckCount = "update-check-count"; 114 static constexpr const auto& kPrefsUpdateCheckResponseHash = 115 "update-check-response-hash"; 116 static constexpr const auto& kPrefsUpdateCompletedBootTime = 117 "update-completed-boot-time"; 118 static constexpr const auto& kPrefsUpdateCompletedOnBootId = 119 "update-completed-on-boot-id"; 120 static constexpr const auto& kPrefsUpdateDurationUptime = 121 "update-duration-uptime"; 122 static constexpr const auto& kPrefsUpdateFirstSeenAt = "update-first-seen-at"; 123 static constexpr const auto& kPrefsUpdateOverCellularPermission = 124 "update-over-cellular-permission"; 125 static constexpr const auto& kPrefsUpdateOverCellularTargetVersion = 126 "update-over-cellular-target-version"; 127 static constexpr const auto& kPrefsUpdateOverCellularTargetSize = 128 "update-over-cellular-target-size"; 129 static constexpr const auto& kPrefsUpdateServerCertificate = 130 "update-server-cert"; 131 static constexpr const auto& kPrefsUpdateStateNextDataLength = 132 "update-state-next-data-length"; 133 static constexpr const auto& kPrefsUpdateStateNextDataOffset = 134 "update-state-next-data-offset"; 135 static constexpr const auto& kPrefsUpdateStateNextOperation = 136 "update-state-next-operation"; 137 static constexpr const auto& kPrefsUpdateStatePayloadIndex = 138 "update-state-payload-index"; 139 static constexpr const auto& kPrefsUpdateStateSHA256Context = 140 "update-state-sha-256-context"; 141 static constexpr const auto& kPrefsUpdateStateSignatureBlob = 142 "update-state-signature-blob"; 143 static constexpr const auto& kPrefsUpdateStateSignedSHA256Context = 144 "update-state-signed-sha-256-context"; 145 static constexpr const auto& kPrefsUpdateBootTimestampStart = 146 "update-boot-timestamp-start"; 147 static constexpr const auto& kPrefsUpdateTimestampStart = 148 "update-timestamp-start"; 149 static constexpr const auto& kPrefsUrlSwitchCount = "url-switch-count"; 150 static constexpr const auto& kPrefsVerityWritten = "verity-written"; 151 static constexpr const auto& kPrefsWallClockScatteringWaitPeriod = 152 "wall-clock-wait-period"; 153 static constexpr const auto& kPrefsWallClockStagingWaitPeriod = 154 "wall-clock-staging-wait-period"; 155 static constexpr const auto& kPrefsManifestBytes = "manifest-bytes"; 156 static constexpr const auto& kPrefsPreviousSlot = "previous-slot"; 157 158 // Keys used when storing and loading payload properties. 159 // These four fields are generated by scripts/brillo_update_payload. 160 static constexpr const auto& kPayloadPropertyFileSize = "FILE_SIZE"; 161 static constexpr const auto& kPayloadPropertyFileHash = "FILE_HASH"; 162 static constexpr const auto& kPayloadPropertyMetadataSize = "METADATA_SIZE"; 163 static constexpr const auto& kPayloadPropertyMetadataHash = "METADATA_HASH"; 164 // The Authorization: HTTP header to be sent when downloading the payload. 165 static constexpr const auto& kPayloadPropertyAuthorization = "AUTHORIZATION"; 166 // The User-Agent HTTP header to be sent when downloading the payload. 167 static constexpr const auto& kPayloadPropertyUserAgent = "USER_AGENT"; 168 // Set "POWERWASH=1" to powerwash (factory data reset) the device after 169 // applying the update. 170 static constexpr const auto& kPayloadPropertyPowerwash = "POWERWASH"; 171 // The network id to pass to android_setprocnetwork before downloading. 172 // This can be used to zero-rate OTA traffic by sending it over the correct 173 // network. 174 static constexpr const auto& kPayloadPropertyNetworkId = "NETWORK_ID"; 175 // Set "SWITCH_SLOT_ON_REBOOT=0" to skip marking the updated partitions active. 176 // The default is 1 (always switch slot if update succeeded). 177 static constexpr const auto& kPayloadPropertySwitchSlotOnReboot = 178 "SWITCH_SLOT_ON_REBOOT"; 179 // Set "RUN_POST_INSTALL=0" to skip running optional post install. 180 // The default is 1 (always run post install). 181 static constexpr const auto& kPayloadPropertyRunPostInstall = 182 "RUN_POST_INSTALL"; 183 184 static constexpr const auto& kOmahaUpdaterVersion = "0.1.0.0"; 185 186 // X-Goog-Update headers. 187 // X-Goog-Update headers. 188 static constexpr const auto& kXGoogleUpdateInteractivity = 189 "X-Goog-Update-Interactivity"; 190 static constexpr const auto& kXGoogleUpdateAppId = "X-Goog-Update-AppId"; 191 static constexpr const auto& kXGoogleUpdateUpdater = "X-Goog-Update-Updater"; 192 static constexpr const auto& kXGoogleUpdateSessionId = "X-Goog-SessionId"; 193 194 // A download source is any combination of protocol and server (that's of 195 // interest to us when looking at UMA metrics) using which we may download 196 // the payload. 197 typedef enum { 198 kDownloadSourceHttpsServer, // UMA Binary representation: 0001 199 kDownloadSourceHttpServer, // UMA Binary representation: 0010 200 kDownloadSourceHttpPeer, // UMA Binary representation: 0100 201 202 // Note: Add new sources only above this line. 203 kNumDownloadSources 204 } DownloadSource; 205 206 // A payload can be a Full or Delta payload. In some cases, a Full payload is 207 // used even when a Delta payload was available for the update, called here 208 // ForcedFull. The PayloadType enum is only used to send UMA metrics about the 209 // successfully applied payload. 210 typedef enum { 211 kPayloadTypeFull, 212 kPayloadTypeDelta, 213 kPayloadTypeForcedFull, 214 215 // Note: Add new payload types only above this line. 216 kNumPayloadTypes 217 } PayloadType; 218 219 // Maximum number of times we'll allow using p2p for the same update payload. 220 constexpr int kMaxP2PAttempts = 10; 221 222 // Maximum wallclock time we allow attempting to update using p2p for 223 // the same update payload - five days. 224 constexpr int kMaxP2PAttemptTimeSeconds = 5 * 24 * 60 * 60; 225 226 // The maximum amount of time to spend waiting for p2p-client(1) to 227 // return while waiting in line to use the LAN - six hours. 228 constexpr int kMaxP2PNetworkWaitTimeSeconds = 6 * 60 * 60; 229 230 // The maximum number of payload files to keep in /var/cache/p2p. 231 constexpr int kMaxP2PFilesToKeep = 3; 232 233 // The maximum number of days to keep a p2p file; 234 constexpr int kMaxP2PFileAgeDays = 5; 235 236 // The default number of UMA buckets for metrics. 237 constexpr int kNumDefaultUmaBuckets = 50; 238 239 // General constexprants 240 constexpr int kNumBytesInOneMiB = 1024 * 1024; 241 242 // Number of redirects allowed when downloading. 243 constexpr int kDownloadMaxRedirects = 10; 244 245 // The minimum average speed that downloads must sustain... 246 // 247 // This is set low because some devices may have very poor 248 // connectivity and we want to make as much forward progress as 249 // possible. For p2p this is high (25 kB/second) since we can assume 250 // high bandwidth (same LAN) and we want to fail fast. 251 constexpr int kDownloadLowSpeedLimitBps = 1; 252 constexpr int kDownloadP2PLowSpeedLimitBps = 25 * 1000; 253 254 // ... measured over this period. 255 // 256 // For non-official builds (e.g. typically built on a developer's 257 // workstation and served via devserver) bump this since it takes time 258 // for the workstation to generate the payload. For normal operation 259 // and p2p, make this relatively low since we want to fail fast in 260 // those cases. 261 constexpr int kDownloadLowSpeedTimeSeconds = 30; 262 constexpr int kDownloadDevModeLowSpeedTimeSeconds = 180; 263 constexpr int kDownloadP2PLowSpeedTimeSeconds = 60; 264 265 // The maximum amount of HTTP server reconnect attempts. 266 // 267 // This is set high in order to maximize the attempt's chance of 268 // succeeding. When using p2p, this is low in order to fail fast. 269 constexpr int kDownloadMaxRetryCount = 20; 270 constexpr int kDownloadMaxRetryCountOobeNotComplete = 3; 271 constexpr int kDownloadMaxRetryCountInteractive = 3; 272 constexpr int kDownloadP2PMaxRetryCount = 5; 273 274 // The connect timeout, in seconds. 275 // 276 // This is set high because some devices may have very poor 277 // connectivity and we may be using HTTPS which involves complicated 278 // multi-roundtrip setup. For p2p, this is set low because we can 279 // the server is on the same LAN and we want to fail fast. 280 constexpr int kDownloadConnectTimeoutSeconds = 30; 281 constexpr int kDownloadP2PConnectTimeoutSeconds = 5; 282 283 // Size in bytes of SHA256 hash. 284 constexpr int kSHA256Size = 32; 285 286 // A hardcoded label to mark end of all InstallOps 287 // This number must be greater than number of install ops. 288 // Number of install ops is bounded by number of blocks on any partition. 289 // Currently, the block size is 4096. Using |kEndOfInstallLabel| of 2^48 will 290 // allow partitions with 2^48 * 4096 = 2^60 bytes. That's 1024PB? Partitions on 291 // android aren't getting that big any time soon. 292 constexpr uint64_t kEndOfInstallLabel = (1ULL << 48); 293 294 } // namespace chromeos_update_engine 295 296 #endif // UPDATE_ENGINE_COMMON_CONSTANTS_H_ 297