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 176 // Proxy URL to use for downloading OTA. This will be forwarded to libcurl 177 static constexpr const auto& kPayloadPropertyNetworkProxy = "NETWORK_PROXY"; 178 179 // Set Virtual AB Compression's compression algorithm to "none", but still use 180 // userspace snapshots and snapuserd for update installation. 181 static constexpr const auto& kPayloadVABCNone = "VABC_NONE"; 182 // Enable/Disable VABC, falls back on plain VAB 183 static constexpr const auto& kPayloadDisableVABC = "DISABLE_VABC"; 184 // Enable multi-threaded compression for VABC 185 static constexpr const auto& kPayloadEnableThreading = "ENABLE_THREADING"; 186 // Enable batched writes for VABC 187 static constexpr const auto& kPayloadBatchedWrites = "BATCHED_WRITES"; 188 189 // Max retry count for download 190 static constexpr const auto& kPayloadDownloadRetry = "DOWNLOAD_RETRY"; 191 192 // Set "SWITCH_SLOT_ON_REBOOT=0" to skip marking the updated partitions active. 193 // The default is 1 (always switch slot if update succeeded). 194 static constexpr const auto& kPayloadPropertySwitchSlotOnReboot = 195 "SWITCH_SLOT_ON_REBOOT"; 196 // Set "RUN_POST_INSTALL=0" to skip running optional post install. 197 // The default is 1 (always run post install). 198 static constexpr const auto& kPayloadPropertyRunPostInstall = 199 "RUN_POST_INSTALL"; 200 201 static constexpr const auto& kOmahaUpdaterVersion = "0.1.0.0"; 202 203 // X-Goog-Update headers. 204 // X-Goog-Update headers. 205 static constexpr const auto& kXGoogleUpdateInteractivity = 206 "X-Goog-Update-Interactivity"; 207 static constexpr const auto& kXGoogleUpdateAppId = "X-Goog-Update-AppId"; 208 static constexpr const auto& kXGoogleUpdateUpdater = "X-Goog-Update-Updater"; 209 static constexpr const auto& kXGoogleUpdateSessionId = "X-Goog-SessionId"; 210 211 // Proxy URL for direction connection 212 static constexpr const auto& kNoProxy = "direct://"; 213 214 // A download source is any combination of protocol and server (that's of 215 // interest to us when looking at UMA metrics) using which we may download 216 // the payload. 217 typedef enum { 218 kDownloadSourceHttpsServer, // UMA Binary representation: 0001 219 kDownloadSourceHttpServer, // UMA Binary representation: 0010 220 kDownloadSourceHttpPeer, // UMA Binary representation: 0100 221 222 // Note: Add new sources only above this line. 223 kNumDownloadSources 224 } DownloadSource; 225 226 // A payload can be a Full or Delta payload. In some cases, a Full payload is 227 // used even when a Delta payload was available for the update, called here 228 // ForcedFull. The PayloadType enum is only used to send UMA metrics about the 229 // successfully applied payload. 230 typedef enum { 231 kPayloadTypeFull, 232 kPayloadTypeDelta, 233 kPayloadTypeForcedFull, 234 235 // Note: Add new payload types only above this line. 236 kNumPayloadTypes 237 } PayloadType; 238 239 // Maximum number of times we'll allow using p2p for the same update payload. 240 constexpr int kMaxP2PAttempts = 10; 241 242 // Maximum wallclock time we allow attempting to update using p2p for 243 // the same update payload - five days. 244 constexpr int kMaxP2PAttemptTimeSeconds = 5 * 24 * 60 * 60; 245 246 // The maximum amount of time to spend waiting for p2p-client(1) to 247 // return while waiting in line to use the LAN - six hours. 248 constexpr int kMaxP2PNetworkWaitTimeSeconds = 6 * 60 * 60; 249 250 // The maximum number of payload files to keep in /var/cache/p2p. 251 constexpr int kMaxP2PFilesToKeep = 3; 252 253 // The maximum number of days to keep a p2p file; 254 constexpr int kMaxP2PFileAgeDays = 5; 255 256 // The default number of UMA buckets for metrics. 257 constexpr int kNumDefaultUmaBuckets = 50; 258 259 // General constexprants 260 constexpr int kNumBytesInOneMiB = 1024 * 1024; 261 262 // Number of redirects allowed when downloading. 263 constexpr int kDownloadMaxRedirects = 10; 264 265 // The minimum average speed that downloads must sustain... 266 // 267 // This is set low because some devices may have very poor 268 // connectivity and we want to make as much forward progress as 269 // possible. For p2p this is high (25 kB/second) since we can assume 270 // high bandwidth (same LAN) and we want to fail fast. 271 constexpr int kDownloadLowSpeedLimitBps = 1; 272 constexpr int kDownloadP2PLowSpeedLimitBps = 25 * 1000; 273 274 // ... measured over this period. 275 // 276 // For non-official builds (e.g. typically built on a developer's 277 // workstation and served via devserver) bump this since it takes time 278 // for the workstation to generate the payload. For normal operation 279 // and p2p, make this relatively low since we want to fail fast in 280 // those cases. 281 constexpr int kDownloadLowSpeedTimeSeconds = 30; 282 constexpr int kDownloadDevModeLowSpeedTimeSeconds = 180; 283 constexpr int kDownloadP2PLowSpeedTimeSeconds = 60; 284 285 // The maximum amount of HTTP server reconnect attempts. 286 // 287 // This is set high in order to maximize the attempt's chance of 288 // succeeding. When using p2p, this is low in order to fail fast. 289 constexpr int kDownloadMaxRetryCount = 20; 290 constexpr int kDownloadMaxRetryCountOobeNotComplete = 3; 291 constexpr int kDownloadMaxRetryCountInteractive = 3; 292 constexpr int kDownloadP2PMaxRetryCount = 5; 293 294 // The connect timeout, in seconds. 295 // 296 // This is set high because some devices may have very poor 297 // connectivity and we may be using HTTPS which involves complicated 298 // multi-roundtrip setup. For p2p, this is set low because we can 299 // the server is on the same LAN and we want to fail fast. 300 constexpr int kDownloadConnectTimeoutSeconds = 30; 301 constexpr int kDownloadP2PConnectTimeoutSeconds = 5; 302 303 // Size in bytes of SHA256 hash. 304 constexpr int kSHA256Size = 32; 305 306 // A hardcoded label to mark end of all InstallOps 307 // This number must be greater than number of install ops. 308 // Number of install ops is bounded by number of blocks on any partition. 309 // Currently, the block size is 4096. Using |kEndOfInstallLabel| of 2^48 will 310 // allow partitions with 2^48 * 4096 = 2^60 bytes. That's 1024PB? Partitions on 311 // android aren't getting that big any time soon. 312 constexpr uint64_t kEndOfInstallLabel = (1ULL << 48); 313 314 } // namespace chromeos_update_engine 315 316 #endif // UPDATE_ENGINE_COMMON_CONSTANTS_H_ 317