summaryrefslogtreecommitdiff
path: root/chromium/net/base/mime_sniffer.h
diff options
context:
space:
mode:
Diffstat (limited to 'chromium/net/base/mime_sniffer.h')
-rw-r--r--chromium/net/base/mime_sniffer.h62
1 files changed, 62 insertions, 0 deletions
diff --git a/chromium/net/base/mime_sniffer.h b/chromium/net/base/mime_sniffer.h
new file mode 100644
index 00000000000..77f3833fe85
--- /dev/null
+++ b/chromium/net/base/mime_sniffer.h
@@ -0,0 +1,62 @@
+// Copyright (c) 2011 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef NET_BASE_MIME_SNIFFER_H__
+#define NET_BASE_MIME_SNIFFER_H__
+
+#include <string>
+
+#include "net/base/net_export.h"
+
+class GURL;
+
+namespace net {
+
+// The maximum number of bytes used by any internal mime sniffing routine. May
+// be useful for callers to determine an efficient buffer size to pass to
+// |SniffMimeType|.
+// This must be updated if any internal sniffing routine needs more bytes.
+const int kMaxBytesToSniff = 1024;
+
+// Examine the URL and the mime_type and decide whether we should sniff a
+// replacement mime type from the content.
+//
+// @param url The URL from which we obtained the content.
+// @param mime_type The current mime type, e.g. from the Content-Type header.
+// @return Returns true if we should sniff the mime type.
+NET_EXPORT bool ShouldSniffMimeType(const GURL& url,
+ const std::string& mime_type);
+
+// Guess a mime type from the first few bytes of content an its URL. Always
+// assigns |result| with its best guess of a mime type.
+//
+// @param content A buffer containing the bytes to sniff.
+// @param content_size The number of bytes in the |content| buffer.
+// @param url The URL from which we obtained this content.
+// @param type_hint The current mime type, e.g. from the Content-Type header.
+// @param result Address at which to place the sniffed mime type.
+// @return Returns true if we have enough content to guess the mime type.
+NET_EXPORT bool SniffMimeType(const char* content, size_t content_size,
+ const GURL& url, const std::string& type_hint,
+ std::string* result);
+
+// Attempt to identify a MIME type from the first few bytes of content only.
+// Uses a bigger set of media file searches than |SniffMimeType()|.
+// If finds a match, fills in |result| and returns true,
+// otherwise returns false.
+//
+// The caller should understand the security ramifications of trusting
+// uncontrolled data before accepting the results of this function.
+//
+// @param content A buffer containing the bytes to sniff.
+// @param content_size The number of bytes in the |content| buffer.
+// @param result Address at which to place the sniffed mime type.
+// @return Returns true if a MIME type match was found.
+NET_EXPORT bool SniffMimeTypeFromLocalData(const char* content,
+ size_t content_size,
+ std::string* result);
+
+} // namespace net
+
+#endif // NET_BASE_MIME_SNIFFER_H__