![]() |
![]() |
![]() |
GStreamer Core Plugins 0.10 Plugins Reference Manual | ![]() |
---|---|---|---|---|
"fd" gint : Read "location" gchar* : 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 <[email protected]> |
class | Source/File |
"fd"
property"fd" gint : Read
File-descriptor for the file being mmap()d.
Allowed values: >= 0
Default value: 0
"location"
property"location" gchar* : Read / Write
Location of the file to read.
Default value: NULL
"touch"
property"touch" gboolean : Read / Write
Touch mmapped data regions to force them to be read from disk.
Default value: TRUE
"use-mmap"
property"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