/**@class android.os.DropBoxManager
@extends java.lang.Object

 Enqueues chunks of data (from various sources -- application crashes, kernel
 log records, etc.).  The queue is size bounded and will drop old data if the
 enqueued data exceeds the maximum size.  You can think of this as a
 persistent, system-wide, blob-oriented "logcat".

 <p>You can obtain an instance of this class by calling
 {@link android.content.Context#getSystemService}
 with {@link android.content.Context#DROPBOX_SERVICE}.

 <p>DropBoxManager entries are not sent anywhere directly, but other system
 services and debugging tools may scan and upload entries for processing.
*/
var DropBoxManager = {

/**Flag value: Entry's content was deleted to save space. */
IS_EMPTY : "1",
/**Flag value: Content is human-readable UTF-8 text (can be combined with IS_GZIPPED). */
IS_TEXT : "2",
/**Flag value: Content can be decompressed with {@link java.util.zip.GZIPOutputStream}. */
IS_GZIPPED : "4",
/** Broadcast Action: This is broadcast when a new entry is added in the dropbox.
 You must hold the {@link android.Manifest.permission#READ_LOGS} permission
 in order to receive this broadcast.

 <p class="note">This is a protected intent that can only be sent
 by the system.
*/
ACTION_DROPBOX_ENTRY_ADDED : "android.intent.action.DROPBOX_ENTRY_ADDED",
/** Extra for {@link android.os.DropBoxManager#ACTION_DROPBOX_ENTRY_ADDED}:
 string containing the dropbox tag.
*/
EXTRA_TAG : "tag",
/** Extra for {@link android.os.DropBoxManager#ACTION_DROPBOX_ENTRY_ADDED}:
 long integer value containing time (in milliseconds since January 1, 1970 00:00:00 UTC)
 when the entry was created.
*/
EXTRA_TIME : "time",
/**Stores human-readable text.  The data may be discarded eventually (or even
 immediately) if space is limited, or ignored entirely if the tag has been
 blocked (see {@link #isTagEnabled}).
@param {String} tag describing the type of entry being stored
@param {String} data value to store
*/
addText : function(  ) {},

/**Stores binary data, which may be ignored or discarded as with {@link #addText}.
@param {String} tag describing the type of entry being stored
@param {Object {byte[]}} data value to store
@param {Number} flags describing the data
*/
addData : function(  ) {},

/**Stores the contents of a file, which may be ignored or discarded as with
 {@link #addText}.
@param {String} tag describing the type of entry being stored
@param {Object {File}} file to read from
@param {Number} flags describing the data
@throws IOException if the file can't be opened
*/
addFile : function(  ) {},

/**Checks any blacklists (set in system settings) to see whether a certain
 tag is allowed.  Entries with disabled tags will be dropped immediately,
 so you can save the work of actually constructing and sending the data.
@param {String} tag that would be used in {@link #addText} or {@link #addFile}
@return {Boolean} whether events with that tag would be accepted
*/
isTagEnabled : function(  ) {},

/**Gets the next entry from the drop box <em>after</em> the specified time.
 Requires <code>android.permission.READ_LOGS</code>.  You must always call
 {@link android.os.DropBoxManager.Entry#close()} on the return value!
@param {String} tag of entry to look for, null for all tags
@param {Number} msec time of the last entry seen
@return {Object {android.os.DropBoxManager.Entry}} the next entry, or null if there are no more entries
*/
getNextEntry : function(  ) {},


};