diff options
Diffstat (limited to 'chromium/net/base/mime_sniffer.h')
-rw-r--r-- | chromium/net/base/mime_sniffer.h | 62 |
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__ |