'\" t
.\"     Title: w1sensors
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 01/06/2017
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "W1SENSORS" "1" "01/06/2017" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
w1sensors \- Convert w1find output to w1retap configuration (text or SQL)
.SH "SYNOPSIS"
.sp
\fBw1sensors\fR [\fIOPTIONS\fR] [\fIFILE\fR]
.SH "DESCRIPTION"
.sp
w1sensors is used to convert the output of w1find into configuration for w1retap\&. It can read from stdin or a FILE and can output to STDOUT or a file with the \-o option\&. By default it outputs SQL statements that insert the sensor configuration into a w1retap database\&. Alternatively with the \-f option it will output file based configuration\&.
.SH "OPTIONS"
.PP
\fB\-?, \-\-help\fR
.RS 4
Show help options
.RE
.PP
\fB\-f, \-\-file\-based\-config\fR
.RS 4
Output file type w1reftap configuration rather than SQL
.RE
.PP
\fB\-o, \-\-output\fR
.RS 4
Output to file
.RE
.SH "EXAMPLE"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
$ sudo \-u w1retap w1find /dev/ttyUSBS0 | w1sensors | psql w1retap
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
$ w1find DS2490\-1 | w1sensors \-f | tee \-a /etc/w1retap\-sensors\&.dat
.RE
.SH "EXIT STATUS"
.PP
\fB0\fR
.RS 4
Returns 0
.RE
.SH "SEE ALSO"
.sp
w1find(1), w1retap(1)
.SH "RESOURCES"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
/usr/share/doc/w1retap\-doc/w1retap\&.odt
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
http://www\&.zen35309\&.zen\&.co\&.uk/wx/tech\&.html
.RE
.SH "AUTHOR"
.sp
This manual page was written by Thomas Stewart <thomas@stewarts\&.org\&.uk> for the Debian GNU/Linux system (but may be used by others)\&. Permission is granted to modify and distribute this manpage under the terms of GNU General Public Licence version 2 or (at your oppinion) any later version\&.