)]}' { "log": [ { "commit": "dc92c82b4180e8067f1acd00a7db7935afce00ff", "tree": "4c108ce188aba5c0f2df9c8746fcabe981a47e64", "parents": [ "83a7cdc56539d00933c2e25999620cec94c524b6" ], "author": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Fri May 13 15:38:02 2011 -0700" }, "committer": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Fri May 13 15:38:02 2011 -0700" }, "message": "Full backup tweaks\n\n* provide placeholder UI showing backup/restore start/stop/timeout\n* don\u0027t kill the progress UI in mid stream\n* tidy up the pax extended header data writing a little\n\nChange-Id: Ife0cb78e3facb541d8327f1d5ca5fe77faa6cbca\n" }, { "commit": "83a7cdc56539d00933c2e25999620cec94c524b6", "tree": "9243436e7e7a01b79258c3689a3f44be88e12594", "parents": [ "c6c8ada1632b9ea0ff87c1caa1141f93ec2256b2" ], "author": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Thu May 12 17:47:12 2011 -0700" }, "committer": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Thu May 12 18:07:57 2011 -0700" }, "message": "Use pax extended tar format to support long filenames etc.\n\n\u0027tar\u0027 supports only 100-character paths; \u0027ustar\u0027 supports only\n155+100 character prefix + paths; neither supports files larger\nthan about 8 gigabytes. We now use the POSIX.1-2001 \u0027pax\u0027\nextended tar format for those files in the backup stream that\nare too large or have too-long paths for the \u0027ustar\u0027 format.\n\nChange-Id: I2f256823091deaec9b1ccea685d2344753c6cb67\n" }, { "commit": "4a627c71ff53a4fca1f961f4b1dcc0461df18a06", "tree": "270190b1e030424210b6375ca886c45db10c4fb6", "parents": [ "2bb51bb203c117649db10ad8bd497f199ca797b0" ], "author": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Fri Apr 01 14:43:32 2011 -0700" }, "committer": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Tue May 10 17:52:51 2011 -0700" }, "message": "Full local backup infrastructure\n\nThis is the basic infrastructure for pulling a full(*) backup of the\ndevice\u0027s data over an adb(**) connection to the local device. The\nbasic process consists of these interacting pieces:\n\n1. The framework\u0027s BackupManagerService, which coordinates the\n collection of app data and routing to the destination.\n\n2. A new framework-provided BackupAgent implementation called\n FullBackupAgent, which is instantiated in the target applications\u0027\n processes in turn, and knows how to emit a datastream that contains\n all of the app\u0027s saved data files.\n\n3. A new shell-level program called \"bu\" that is used to bridge from\n adb to the framework\u0027s Backup Manager.\n\n4. adb itself, which now knows how to use \u0027bu\u0027 to kick off a backup\n operation and pull the resulting data stream to the desktop host.\n\n5. A system-provided application that verifies with the user that\n an attempted backup/restore operation is in fact expected and to\n be allowed.\n\nThe full agent implementation is not used during normal operation of\nthe delta-based app-customized remote backup process. Instead it\u0027s\nused during user-confirmed *full* backup of applications and all their\ndata to a local destination, e.g. via the adb connection.\n\nThe output format is \u0027tar\u0027. This makes it very easy for the end\nuser to examine the resulting dataset, e.g. for purpose of extracting\nfiles for debug purposes; as well as making it easy to contemplate\nadding things like a direct gzip stage to the data pipeline during\nbackup/restore. It also makes it convenient to construct and maintain\nsynthetic backup datasets for testing purposes.\n\nWithin the tar format, certain artificial conventions are used.\nAll files are stored within top-level directories according to\ntheir semantic origin:\n\napps/pkgname/a/ : Application .apk file itself\napps/pkgname/obb/: The application\u0027s associated .obb containers\napps/pkgname/f/ : The subtree rooted at the getFilesDir() location\napps/pkgname/db/ : The subtree rooted at the getDatabasePath() parent\napps/pkgname/sp/ : The subtree rooted at the getSharedPrefsFile() parent\napps/pkgname/r/ : Files stored relative to the root of the app\u0027s file tree\napps/pkgname/c/ : Reserved for the app\u0027s getCacheDir() tree; not stored.\n\nFor each package, the first entry in the tar stream is a file called\n\"_manifest\", nominally rooted at apps/pkgname. This file contains some\nmetadata about the package whose data is stored in the archive.\n\nThe contents of shared storage can optionally be included in the tar\nstream. It is placed in the synthetic location:\n\nshared/...\n\nuid/gid are ignored; app uids are assigned at install time, and the\napp\u0027s data is handled from within its own execution environment, so\nwill automatically have the app\u0027s correct uid.\n\nForward-locked .apk files are never backed up. System-partition\n.apk files are not backed up unless they have been overridden by a\npost-factory upgrade, in which case the current .apk *is* backed up --\ni.e. the .apk that matches the on-disk data. The manifest preceding\neach application\u0027s portion of the tar stream provides version numbers\nand signature blocks for version checking, as well as an indication\nof whether the restore logic should expect to install the .apk before\nextracting the data.\n\nSystem packages can designate their own full backup agents. This is\nto manage things like the settings provider which (a) cannot be shut\ndown on the fly in order to do a clean snapshot of their file trees,\nand (b) manage data that is not only irrelevant but actively hostile\nto non-identical devices -- CDMA telephony settings would seriously\nmess up a GSM device if emplaced there blind, for example.\n\nWhen a full backup or restore is initiated from adb, the system will\npresent a confirmation UI that the user must explicitly respond to\nwithin a short [~ 30 seconds] timeout. This is to avoid the\npossibility of malicious desktop-side software secretly grabbing a copy\nof all the user\u0027s data for nefarious purposes.\n\n(*) The backup is not strictly a full mirror. In particular, the\n settings database is not cloned; it is handled the same way that\n it is in cloud backup/restore. This is because some settings\n are actively destructive if cloned onto a different (or\n especially a different-model) device: telephony settings and\n AndroidID are good examples of this.\n\n(**) On the framework side it doesn\u0027t care that it\u0027s adb; it just\n sends the tar stream to a file descriptor. This can easily be\n retargeted around whatever transport we might decide to use\n in the future.\n\nKNOWN ISSUES:\n\n* the security UI is desperately ugly; no proper designs have yet\n been done for it\n* restore is not yet implemented\n* shared storage backup is not yet implemented\n* symlinks aren\u0027t yet handled, though some infrastructure for\n dealing with them has been put in place.\n\nChange-Id: Ia8347611e23b398af36ea22c36dff0a276b1ce91\n" }, { "commit": "568bc32344dce841c8f6958f1a65ff839a1b64c0", "tree": "6c7f946386e088900b9cda0c66c2e22b1b987dc0", "parents": [ "12a4da328a234b171b78cc341544817e9a074057" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Fri Jun 26 17:19:11 2009 -0400" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Fri Jun 26 17:19:11 2009 -0400" }, "message": "Better (and less) logging from backup.\n" }, { "commit": "63bcb79dd437e70593b63cc5a87baab3251c2183", "tree": "97eab12039e80d6f16d64e2c3d7dac2073dfae54", "parents": [ "54118adb3766fdf73a409102b88d7494bb6889a3" ], "author": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Wed Jun 24 13:57:29 2009 -0700" }, "committer": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Wed Jun 24 13:57:29 2009 -0700" }, "message": "Only report \"unknown metadata\" once per restore helper\n\nAlso removes the auto-free object, replacing it with direct memory manipulation.\n" }, { "commit": "54118adb3766fdf73a409102b88d7494bb6889a3", "tree": "0cc282e2f39bf2ac885173caef1d31f22c087401", "parents": [ "0e034e5a9a71e5e196baff630dca796a0e3ed3e2" ], "author": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Wed Jun 24 11:20:51 2009 -0700" }, "committer": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Wed Jun 24 11:20:51 2009 -0700" }, "message": "Put back LOGP -\u003e printf in the backup helper code\n" }, { "commit": "fbb92385f2fb0ae1146bb8f3d73547d90bda6db1", "tree": "3c02712ab875ae1889d3b0a2df244ef3cc205410", "parents": [ "3fbd946bacdc202dc23c84887d2ad47402b5015b" ], "author": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Tue Jun 23 17:35:11 2009 -0700" }, "committer": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Tue Jun 23 17:40:44 2009 -0700" }, "message": "Preserve file access mode when backing up / restoring files\n\nThis change adds a fixed-size metadata block at the head of each file\u0027s content\nentity. The block is versioned, and fixed-size on the theory that it might be\nnice to be able to recover the content (if not the full metadata) of the files\nif we\u0027re ever confronted with data backed up some hypothetical future helper\nthat stored expanded metadata.\n\nThe net effect is that now on restore, we assign the same access mode to the\nfile that it originally had when backed up.\n\nAlso, some of the code was failing to properly free transient heap-based buffers\nwhen it encountered errors. This has been fixed with the addition of a tiny\nstack-based object whose job it is to free() its designated pointer from its\ndestructor.\n" }, { "commit": "11b157790234d3d2f116ce4c7ed1d3d00fb78bc3", "tree": "1db558751d0c942f0c231a0de9de5965aa1d50ba", "parents": [ "2e418428987132ea66533cbc05f9c526eb59519a" ], "author": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Tue Jun 23 13:03:00 2009 -0700" }, "committer": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Tue Jun 23 13:07:47 2009 -0700" }, "message": "Add file mode to the file-backup saved state blobs\n\nThis change puts the file\u0027s access mode into the saved-state blob used by the\nfile backup helpers. The tests have been updated for the new blob content\nformat.\n\nWhat this change *doesn\u0027t* do is actually backup/restore the file mode. This\nchange is a prerequisite for that, but mode preservation in backup/restore will\nrequire adding metadata to the backup data stream itself, so will be approached\na bit more carefully.\n\n(Also fixed one outright bug in the test program: ReadEntityData() had been\nchanged to return a ssize_t union of either a byte-count or a negative number\nindicating error, but the test program was still assuming that nonzero \u003d\u003d error,\nand was spuriously failing.)\n" }, { "commit": "5d605dc56b036232e885f6ec36b888b729673060", "tree": "8a29f6a2feb495cbac08bb43b08e0ca9b8cf7dce", "parents": [ "d2d9ceb7305d593c1b767bbb05de0082a9af4109" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Thu Jun 18 18:23:43 2009 -0700" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Thu Jun 18 18:41:11 2009 -0700" }, "message": "backup stuff\n" }, { "commit": "d2d9ceb7305d593c1b767bbb05de0082a9af4109", "tree": "1ba39c3c5901d65a18855286e240f177820a6ec6", "parents": [ "abce4e8714bed26a2b37b20ad3f02cf619d71c9a" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Thu Jun 18 13:11:18 2009 -0700" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Thu Jun 18 18:41:11 2009 -0700" }, "message": "Make RestoreHelper and friends also write out the snapshot state.\n" }, { "commit": "5f15d151b5101fadfe6cba1e8f4aa6367e8c603e", "tree": "3a94295ffc2935c7ca1550c01a6e793766bf415f", "parents": [ "aa088447baadd2e0bbcfd18cc529645610c13ddc" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Tue Jun 16 16:31:35 2009 -0400" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Tue Jun 16 18:46:50 2009 -0700" }, "message": "checkpoint BackupDatAInput / RestoreHelper\n" }, { "commit": "ce88cb15b52998e16c3ba548a4ec49117a835e21", "tree": "dc02e85657a63858b45a5eef8f99cbf5efae6339", "parents": [ "23ecae3bbb60c5af940f3a22170d75eb6ac05b69" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Thu Jun 11 11:27:16 2009 -0700" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Thu Jun 11 14:51:45 2009 -0700" }, "message": "Make the file backup helper not crash if a file you requested\ncan\u0027t be stated. This means you don\u0027t need to know if the files\nyou are backing up exist or not -- we\u0027ll figure it out for you.\n" }, { "commit": "23ecae3bbb60c5af940f3a22170d75eb6ac05b69", "tree": "1138102ba856743cffd931121409a71c2bae37c3", "parents": [ "0b77453076a22569f24318d194b378b68f11a63e" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Wed Jun 10 17:07:15 2009 -0700" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Thu Jun 11 11:29:57 2009 -0700" }, "message": "Fix SharedPrefsBackupHelper so it doesn\u0027t hard code the paths to the files.\n\nThis took quite a bit of refactoring.\n" }, { "commit": "0032ce80ac127e6bfb25d727162eee4af208dc77", "tree": "c867a73a9f4fac2e025864c3dd506334c68d6f60", "parents": [ "54de90635e1d0628c396d65e6c948bf4a1529229" ], "author": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Thu Jun 04 17:01:06 2009 -0700" }, "committer": { "name": "Christopher Tate", "email": "ctate@google.com", "time": "Thu Jun 04 17:02:56 2009 -0700" }, "message": "Fix back_up_files() error detection when opening/CRCing the file\n" }, { "commit": "8ae2335a3c93d0c00e998fdec18f64dfe43b94cb", "tree": "e4233d7c7c87d76cab05ebe98a6330f9b4731155", "parents": [ "85dfec8c35d4e3216591bd2e534bbebd6338b969" ], "author": { "name": "Mathias Agopian", "email": "mathias@google.com", "time": "Thu Jun 04 13:53:57 2009 -0700" }, "committer": { "name": "Mathias Agopian", "email": "mathias@google.com", "time": "Thu Jun 04 13:53:57 2009 -0700" }, "message": "rename a few files to camel-case, add copyright notices\n" }, { "commit": "f4c46b94b867f6a01bf7d0be18f667819338072f", "tree": "43b19e5afb0031c6e21982ce5c1ab2e97aee6699", "parents": [ "9d892a8e3037fd2f6d692137cd5d91acc46ddf5a" ], "author": { "name": "Nicolas Catania", "email": "niko@google.com", "time": "Fri May 22 13:41:38 2009 -0700" }, "committer": { "name": "Nicolas Catania", "email": "niko@google.com", "time": "Fri May 22 15:54:26 2009 -0700" }, "message": "Fix for the simultor build breakage.\n\nAdded missing include sys/time.h for utimes.\n\nDetects when stat64 uses a timespec for the modif and access times\nand work around the missing st_*time_nsec.\n\nApologies for the whitespace changes, emacs removed them automatically.\n" }, { "commit": "d2110dbce071a236b6176de344ca797b737542eb", "tree": "996e044c8c7bf49463394bc911f0277d969bde5d", "parents": [ "40f5a4ea3bc90e43a442ab336f2342020bba86b3" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Tue May 19 13:41:21 2009 -0700" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Wed May 20 11:24:20 2009 -0700" }, "message": "Hook up the backup data writer, and add a utility to read the backup data files.\n" }, { "commit": "2e1da32203b7f6df76023f25a7382a31fad6b19d", "tree": "4595241ae1e0e2207fc2285774f6fef86320e6b6", "parents": [ "4535e40544aeb957d44fad75fbe5676effe03689" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Fri May 15 18:20:19 2009 -0400" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Fri May 15 18:20:19 2009 -0400" }, "message": "Add the backup data file writer C++ class.\n" }, { "commit": "4535e40544aeb957d44fad75fbe5676effe03689", "tree": "6861c7e610cd7061338b361ecab09d6b19ac3ca6", "parents": [ "eae850cefe7e149f396c9e8ca1f34ec02b20a3f0" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Fri May 15 09:07:06 2009 -0400" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Fri May 15 10:37:10 2009 -0400" }, "message": "Implement the C++ class to write the backed up file data.\n" }, { "commit": "290bb011c5c1a9ba1f2116810b06cf52a9c36b3e", "tree": "cfb9ce077d79021e86c1b8d7951f3655520f368d", "parents": [ "ec2d74d40f9b7a8bf96feeb45a5d054d8b0ce0dd" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Wed May 13 18:57:29 2009 -0400" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Thu May 14 09:39:32 2009 -0400" }, "message": "Get the backup calling through to the file backup helper.\n\nThis includes some cleanup to make the parameters match\nbetween BackupService.onBackup and FileBackupHelper.performBackup.\n" }, { "commit": "c825d3ebd6ca66e65e63fdc76f032e08aa2a8e22", "tree": "dd9eca8ae68aaab8ed8d692ccf425a76541e9972", "parents": [ "1e09a72a75f5e6236acffe84f2758dd042b1c8c0" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Wed May 06 12:55:46 2009 -0400" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Fri May 08 09:33:19 2009 -0700" }, "message": "fix the sim build. disables the tests for now.\n" }, { "commit": "3ad977b41c6e4ef30c2f4f316b909b742ffc04aa", "tree": "0b3c7a5263817709bc31c19e02f9fbc19b63de82", "parents": [ "06d96020c35dac2bf1651cb8bd4cfced911f1142" ], "author": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Tue May 05 11:50:51 2009 -0700" }, "committer": { "name": "Joe Onorato", "email": "joeo@android.com", "time": "Tue May 05 13:45:25 2009 -0700" }, "message": "Add some C++ code to do raw files for backup\n" } ] }