![]() |
![]() |
![]() |
GStreamer Core Plugins 0.10 Plugins Reference Manual | ![]() |
---|---|---|---|---|
"fd" gint : Read "location" gchararray : Read / Write "mmapsize" gulong : Read / Write "touch" gboolean : Read / Write "use-mmap" gboolean : Read / Write "sequential" gboolean : Read / Write
Read data from a file in the local file system.
plugin | coreelements |
author | Erik Walthinsen <omega@cse.ogi.edu> |
class | Source/File |
"fd" gint : Read
File-descriptor for the file being mmap()d.
Allowed values: >= 0
Default value: 0
"location" gchararray : Read / Write
Location of the file to read.
Default value: NULL
"touch" gboolean : Read / Write
Touch mmapped data regions to force them to be read from disk.
Default value: TRUE
"use-mmap" gboolean : Read / Write
Whether to use mmap(). Set to TRUE to force use of mmap() instead of read() for reading data.
Use of mmap() is disabled by default since with mmap() there are a number of occasions where the process/application will be notified of read errors via a SIGBUS signal from the kernel, which will lead to the application being killed if not handled by the application. This is something that is difficult to work around for a library like GStreamer, hence use of mmap() is disabled by default. Said errors can occur for example when an external device (e.g. an external hard drive or a portable music player) are unplugged while in use, or when a CD/DVD medium cannot be be read because the medium is scratched or otherwise damaged.
Default value: FALSE