doc/html/sfeed_update.1.html


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
147
148
149
150
151
152
153
154
155
156

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="resource-type" content="document">
<link rel="stylesheet" href="man.css" type="text/css" media="all">
<title>
SFEED_UPDATE(1)</title>
</head>
<body>
<div class="mandoc">
<table summary="Document Header" class="head" width="100%">
<col width="30%">
<col width="30%">
<col width="30%">
<tbody>
<tr>
<td class="head-ltitle">
SFEED_UPDATE(1)</td>
<td class="head-vol" align="center">
OpenBSD Reference Manual</td>
<td class="head-rtitle" align="right">
SFEED_UPDATE(1)</td>
</tr>
</tbody>
</table>
<div class="section">
<h1 id="x4e414d45">NAME</h1> <b class="name">sfeed_update</b> &#8212; <span class="desc">update feeds and merge with old feeds</span></div>
<div class="section">
<h1 id="x53594e4f50534953">SYNOPSIS</h1><table class="synopsis">
<col style="width: 12.00ex;">
<col>
<tbody>
<tr>
<td>
sfeed_update</td>
<td>
&#91;<span class="opt"><i class="arg">configfile</i></span>&#93;</td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h1 id="x4445534352495054494f4e">DESCRIPTION</h1> <b class="name">sfeed_update</b> updates feeds and merges the new data with the previous feeds. This is the file $HOME/.sfeed/feeds by default.</div>
<div class="section">
<h1 id="x4f5054494f4e53">OPTIONS</h1><dl style="margin-top: 0.00em;margin-bottom: 0.00em;" class="list list-tag">
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">configfile</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
config file, if not specified uses the location $HOME/.sfeed/sfeedrc by default see the <i class="link-sec"><a class="link-sec" href="#x46494c45532052454144">FILES READ</a></i> section for more information.</dd>
</dl>
</div>
<div class="section">
<h1 id="x5441421e53455041524154454420464f524d4154204649454c4453">TAB-SEPARATED FORMAT FIELDS</h1> The items are saved in a TSV-like format except newlines, tabs and backslash are escaped with \ (\n, \t and \\). Carriage returns (\r) are removed.<p>
The order and format of the fields are:<dl style="margin-top: 0.00em;margin-bottom: 0.00em;" class="list list-tag">
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item timestamp</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string, UNIX timestamp in GMT+0</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item timestamp</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string, date and time in the format: YYYY-mm-dd HH:MM:SS tzname[[+-][HHMM]]</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item title</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item link</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item content</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item content&#45;type</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string, &quot;html&quot; or &quot;plain&quot;</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item id</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item author</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">feed type</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string, &quot;rss&quot; or &quot;atom&quot;</dd>
</dl>
</div>
<div class="section">
<h1 id="x4558545241204649454c4453">EXTRA FIELDS</h1> Extra fields added by sfeed_update:<dl style="margin-top: 0.00em;margin-bottom: 0.00em;" class="list list-tag">
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">feed name</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">feed url</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">item baseurl site</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
string</dd>
</dl>
</div>
<div class="section">
<h1 id="x46494c45532052454144">FILES READ</h1><dl style="margin-top: 0.00em;margin-bottom: 0.00em;" class="list list-tag">
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">sfeedrc</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
Config file, see the sfeedrc.example file for an example. This file is evaluated as a shellscript in sfeed_update. You can for example override the fetchfeed() function to use wget, fetch or an other download program or you can override the merge() function to change the merge logic. The function feeds() is called to fetch the feeds. By default the function feed() is executed as a parallel job to speedup updating.</dd>
</dl>
</div>
<div class="section">
<h1 id="x46494c4553205752495454454e">FILES WRITTEN</h1><dl style="margin-top: 0.00em;margin-bottom: 0.00em;" class="list list-tag">
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">feeds</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
Tab-separated format containing all feeds. The sfeed_update script merges new items with this file.</dd>
<dt class="list-tag" style="margin-top: 1.00em;">
<i class="arg">feeds.new</i></dt>
<dd class="list-tag" style="margin-left: 17.00ex;">
Temporary file used by sfeed_update to merge items.</dd>
</dl>
</div>
<div class="section">
<h1 id="x4558414d504c4553">EXAMPLES</h1> To update feeds and format the feeds file:<p>
<pre style="margin-left: 0.00ex;" class="lit display">
sfeed_update &quot;configfile&quot; 
sfeed_plain &lt; $HOME/.sfeed/feeds &gt; $HOME/.sfeed/feeds.txt 
sfeed_html &lt; $HOME/.sfeed/feeds &gt; $HOME/.sfeed/feeds.html</pre>
</div>
<div class="section">
<h1 id="x53454520414c534f">SEE ALSO</h1> <a class="link-man">sh(1)</a>, <a class="link-man">sfeed_plain(1)</a>, <a class="link-man">sfeed_html(1)</a></div>
<div class="section">
<h1 id="x415554484f5253">AUTHORS</h1> <span class="author">Hiltjo Posthuma</span> &#60;<a class="link-mail" href="mailto:hiltjo@codemadness.org">hiltjo@codemadness.org</a>&#62;</div>
<table summary="Document Footer" class="foot" width="100%">
<col width="50%">
<col width="50%">
<tbody>
<tr>
<td class="foot-date">
December 25, 2014</td>
<td class="foot-os" align="right">
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>