Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
UNTITLED()			     LOCAL			    UNTITLED()

NAME
       owrep --	Weather	information utility

SYNOPSIS
       owrep [-c file] [-d delim] [-D] [-h] [-l	location] [-u units] [-z]

DESCRIPTION
       owrep  is  a  simple  utility  for  accessing  the current weather from
       http://www.openweathermap.org, using the	published API.	It can	gener-
       ate  either  a  human-readable  weather summary,	or a compressed	set of
       data in a fixed format, with fields separated by	a specified delimiter.
       The latter is suitable for feeding into other programs for further pro-
       cessing.

       The following options are available:

       -c file	 Specify alternate location for	the configuration file.

       -d delim	 Specify the delimiter for use with  -z;  the  default	is  @.
		 delim must be a single	character.

       -D	 Turn  on  debugging; various progress messages	are generated,
		 and the raw data from http://www.openweathermap.org  is  also
		 output.

       -h	 Display a short help message.

       -l location
		 Specify the location for the weather report. This is a	number
		 obtained  from	http://www.openweathermap.org.	If given, this
		 overrides any value in	the configuration file.

       -u units	 Specify the units to be used for output; the possible	values
		 are  imperial and metric.  These keywords may be abbreviated.
		 If given, this	overrides any value in the configuration file.

       -z	 Generate compressed output.

OUTPUT FORMAT
       In normal output	mode, weather information is generated in a  self  ex-
       planatory, human	readable form.

       In compressed output mode, weather information is generated as a	single
       line  containing	many fields, separated by the specified	delimiter (the
       default being @).  These	fields are as follows. The Type	 column	 indi-
       cates the type of information provided.

	     Number    Type	  Contents
	     1	       string	  City/Town
	     2	       string	  Country
	     3	       real	  Longitude
	     4	       string	  Longitude direction (E or W)
	     5	       real	  Latitude
	     6	       string	  Latitude direction (N	or S)
	     7	       date	  Sunrise date
	     8	       time	  Sunrise time
	     9	       date	  Sunset date
	     10	       time	  Sunset time
	     11	       string	  Temperature units
	     12	       integer	  Temperature now
	     13	       integer	  Temperature minimum
	     14	       integer	  Temperature maximum
	     15	       integer	  Humidity
	     16	       string	  Humidity units
	     17	       integer	  Pressure
	     18	       string	  Pressure units
	     19	       string	  Wind speed units
	     20	       real	  Wind speed
	     21	       string	  Wind speed description
	     22	       real	  Gust speed
	     23	       integer	  Wind direction (bearing)
	     24	       string	  Wind direction code (e.g. SW)
	     25	       string	  Wind direction description
	     26	       integer	  Cloud	cover percentage
	     27	       string	  Cloud	cover description
	     28	       integer	  Visibility distance
	     29	       string	  Visibility units
	     30	       string	  Precipitation	mode
	     31	       integer	  Precipitation
	     32	       string	  Precipitation	units
	     33	       date	  Date of last update
	     34	       time	  Time of last update

FILES
       /usr/local/etc/owrep.conf  default configuration	file

EXIT STATUS
       The owrep utility exits 0 on success, and >0 if an error	occurs.

SEE ALSO
       owrep.conf(5)

AUTHORS
       Bob Eager <bob@eager.cx>.

FreeBSD	ports 15.0		March 04, 2018			      OWREP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=owrep&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help