file.h 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. /*
  2. * This file is part of FFmpeg.
  3. *
  4. * FFmpeg is free software; you can redistribute it and/or
  5. * modify it under the terms of the GNU Lesser General Public
  6. * License as published by the Free Software Foundation; either
  7. * version 2.1 of the License, or (at your option) any later version.
  8. *
  9. * FFmpeg is distributed in the hope that it will be useful,
  10. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  12. * Lesser General Public License for more details.
  13. *
  14. * You should have received a copy of the GNU Lesser General Public
  15. * License along with FFmpeg; if not, write to the Free Software
  16. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  17. */
  18. #ifndef AVUTIL_FILE_H
  19. #define AVUTIL_FILE_H
  20. #include <stdint.h>
  21. #include "avutil.h"
  22. /**
  23. * @file
  24. * Misc file utilities.
  25. */
  26. /**
  27. * Read the file with name filename, and put its content in a newly
  28. * allocated buffer or map it with mmap() when available.
  29. * In case of success set *bufptr to the read or mmapped buffer, and
  30. * *size to the size in bytes of the buffer in *bufptr.
  31. * The returned buffer must be released with av_file_unmap().
  32. *
  33. * @param log_offset loglevel offset used for logging
  34. * @param log_ctx context used for logging
  35. * @return a non negative number in case of success, a negative value
  36. * corresponding to an AVERROR error code in case of failure
  37. */
  38. av_warn_unused_result
  39. int av_file_map(const char *filename, uint8_t **bufptr, size_t *size,
  40. int log_offset, void *log_ctx);
  41. /**
  42. * Unmap or free the buffer bufptr created by av_file_map().
  43. *
  44. * @param size size in bytes of bufptr, must be the same as returned
  45. * by av_file_map()
  46. */
  47. void av_file_unmap(uint8_t *bufptr, size_t size);
  48. /**
  49. * Wrapper to work around the lack of mkstemp() on mingw.
  50. * Also, tries to create file in /tmp first, if possible.
  51. * *prefix can be a character constant; *filename will be allocated internally.
  52. * @return file descriptor of opened file (or negative value corresponding to an
  53. * AVERROR code on error)
  54. * and opened file name in **filename.
  55. * @note On very old libcs it is necessary to set a secure umask before
  56. * calling this, av_tempfile() can't call umask itself as it is used in
  57. * libraries and could interfere with the calling application.
  58. * @deprecated as fd numbers cannot be passed saftely between libs on some platforms
  59. */
  60. int av_tempfile(const char *prefix, char **filename, int log_offset, void *log_ctx);
  61. #endif /* AVUTIL_FILE_H */