1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
rharchive(8)
============
NAME
----
rharchive - Radio Helsinki Archive Daemon
SYNOPSIS
--------
....
rharchive
[ -h|--help ]
[ -D|--nodaemonize ]
[ -u|--username <username> ]
[ -g|--groupname <groupname> ]
[ -C|--chroot <path> ]
[ -P|--write-pid <filename> ]
[ -L|--log <target>:<level>[,<param1>[,<param2>[..]]] ]
[ -U|--debug ]
[ -s|--source <description> ]
[ -d|--output-dir <path> ]
[ -f|--name-format <format> ]
[ -m|--mode <value> ]
[ -n|--nocache ]
[ -i|--interval <value> ]
[ -o|--offset <value> ]
[ -x|--post-process <script> ]
....
DESCRIPTION
-----------
*rharchive* rharchive is small program based on gstreamer. It converts
a raw audio stream into flac or ogg and writes files for every
hour.
OPTIONS
-------
The following options can be passed to the *rharchive* daemon:
*-D, --nodaemonize*::
This option instructs *rharchive* to run in foreground
instead of becoming a daemon which is the default.
*-u, --username <username>*::
run as this user. If no group is specified (*-g*) the default group of
the user is used. The default is to not drop privileges.
*-g, --groupname <groupname>*::
run as this group. If no username is specified (*-u*) this gets ignored.
The default is to not drop privileges.
*-C, --chroot <path>*::
Instruct *rharchive* to run in a chroot jail. The default is
to not run in chroot.
*-P, --write-pid <filename>*::
Instruct *rharchive* to write it's pid to this file. The default is
to not create a pid file.
*-L, --log <target>:<level>[,<param1>[,<param2>[..]]]*::
add log target to logging system. This can be invoked several times
in order to log to different targets at the same time. Every target
has its own log level which is a number between 0 and 5. Where 0 means
disabling log and 5 means debug messages are enabled. +
The file target can be used more than once with different levels.
If no target is provided at the command line a single target with the
config *syslog:3,rharchive,daemon* is added. +
The following targets are supported:
*syslog*;; log to syslog daemon, parameters <level>[,<logname>[,<facility>]]
*file*;; log to file, parameters <level>[,<path>]
*stdout*;; log to standard output, parameters <level>
*stderr*;; log to standard error, parameters <level>
*-U, --debug*::
This option instructs *rharchive* to run in debug mode. It implicits *-D*
(don't daemonize) and adds a log target with the configuration
*stdout:5* (logging with maximum level). In future releases there might
be additional output when this option is supplied.
*-s, --source <description>*::
a gstreamer-style pipeline description which is used as a source.
i.e.: *'pulsesrc ! audioconvert ! vorbisenc ! oggmux'*
this pipeline gets directly connected to the writer element (multifdsink).
*-d, --output-dir <path>*::
the path to the output files.
*-f, --name-format <format>*::
a format string for the filenames. The actual name is generated using strftime.
Please consult the manpage of strftime for details. The default format is:
*'%Y-%m-%d-%H00.ogg'*.
*-m, --mode <value>*::
the octet string for the file permission bits.
*-n, --nocache*::
When this option is given *rharchive* will use the O_DIRECT flag when opening files.
*-i, --interval <value>*::
the interval in ms between the boundary checks. The default is to check every 50ms.
*-o, --offset <value>*::
the offset in ms between the real boundary and the time the file actually starts/stops.
A positive number means that the file starts too late. The default is no offset (0ms).
*-x, --post-process <script>*::
this script gets called for every finished file. By default no script gets called.
BUGS
----
Most likely there are some bugs in *rharchive*. If you find a bug, please let
the developers know at equinox@helsinki.at. Of course, patches are preferred.
SEE ALSO
--------
*strftime*(3), *gst-launch*(1)
AUTHORS
-------
Christian Pointner <equinox@helsinki.at>
RESOURCES
---------
Radio Helsinki Website: http://www.helsinki.at
COPYING
-------
Copyright \(C) 2009-2014 Christian Pointner. This program is free
software: you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or any later version.
|
