| 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