![]() |
![]() |
![]() |
GStreamer Core Plugins 0.10 Plugins Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
"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.
1 |
gst-launch filesrc location=song.ogg ! decodebin2 ! autoaudiosink |
plugin |
coreelements |
author |
Erik Walthinsen <omega@cse.ogi.edu> |
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
"sequential"
property"sequential" gboolean : Read / Write
Whether to use madvise to hint to the kernel that access to mmap pages will be sequential.
Default value: FALSE