1 files changed, 187 insertions, 0 deletions
diff --git a/man/miav.conf.1 b/man/miav.conf.1
new file mode 100644
index 0000000..1719ea6
--- /dev/null
+++ b/man/miav.conf.1
@@ -0,0 +1,187 @@
+.\" Process this file with
+.\" groff -man -Tascii miav.conf.1
+.\"
+.TH MIAV.CONF 1 "June 2005" Linux "User Manuals"
+.SH NAME
+MIaV \- The Multicast Image and Video project. Configuration file.
+.SH SYNOPSIS
+.B /etc/miav.conf
+.SH FORMAT
+.RS
+.RE
+.I [property] = [value]
+.SH FORMAT EXPLANATION
+.TP
+.B property
+is a string without quotes, containing only normal characters. It is
+case sensitive.
+.TP
+.B value
+is one of the following:
+.RS
+.I string
+.RS
+A string is a sequence of characters, double quoted, and not
+containgning newlines.
+.RE
+.I integer
+.RS
+An integer is a normal number, without qoutations, it may only
+contain the characters 0-9.
+.RE
+.I float
+.RS
+A float is a floating point value, written without qoutations and
+using a dot as the decimal indetifier.
+.RE
+.I boolean
+.RS
+A boolean is a string written without quotation, the following
+three is equivalent: 
+.I 1, true, yes.
+The following three are equivalent:
+.I 0, false, no.
+.SH DESCRIPTION
+.RS
+.RE
+MIaV \- The Multicast Image and Video project.
+
+The MIaV configuration file:
+
+.B Log files of the server and the client.
+.RE
+The values 
+.I client_log_file
+and
+.I server_log_file
+needs to be set to a string (double qouted) containing a filename,
+which is writable by the user the program is run by. Please note that
+the
+.I user
+and
+.I group
+properties do not apply to the client.
+
+.B Cpr Database configuration.
+.RE
+The
+.I cpr_host
+property must be set to a string (double quoted) sontaining a valid
+dns name for a cpr server.
+The
+.I cpr_port
+is the port number on which to contact the cpr server, and the
+.I cpr_timeout
+property is the number of miliseconds before bailing out, if the cpr
+server does not reply.
+
+.B Video source.
+.RE
+The
+.I video_width
+and
+.I video_height
+properties are integers setting the width and height of the client
+window.
+
+.B Size of the screen in inches.
+.RE
+.I screensize
+.I pixel_width
+.I pixel_height
+
+.B Skip frames in the player.
+.RE
+.I player_skip_frames
+Set to 1 if client is slow ( less than 1.5 ghz )
+
+.B How and where to connect to the miav server?
+.RE
+.I server_addr
+.I server_port
+
+.B Run the server as the following user:
+.RE
+.I server_user
+.I server_group
+
+.B Where to store the files recieved by the server
+.RE
+.I server_root
+
+.B Video output controls.
+.RE
+.I frame_sequence
+A sequence of I and P, where I is keyframes
+which is fast to create, but uses a lot of discspace.
+P uses changes since last frame, is more cpu intensive, but uses a
+lot less diskspace than I frames
+
+.B Frame quality.
+.RE
+.I frame_quality
+in % - 100% is best quality
+
+.B Encoder threads.
+.RE
+The number of threads started for parallel encoding on the server
+(for multiprocessor systems)
+.I encoding_threads
+
+.B Encoder codec.
+.RE
+Codec is one of the following:
+"mpeg1" For use with mpeg1 encoding.
+"mpeg4" for use with mpeg4 encoding
+default is "mpeg1"
+.I encoding_codec
+.SH EXAMPLE
+.RS
+.RE
+client_log_file	= "/var/log/miav_client.log"
+.RE
+server_log_file	= "/var/log/miav_server.log"
+
+cpr_host	= "cpr.example.com"
+.RE
+cpr_port	= 10301
+.RE
+cpr_timeout	= 10000
+
+video_width	= 720
+.RE
+video_height	= 576
+
+screensize	= 19.0
+.RE
+pixel_width	= 1024
+.RE
+pixel_height	= 768
+
+player_skip_frames = no
+
+server_addr	= "miav.example.com"
+.RE
+server_port	= 18120
+
+server_user	= "miav"
+.RE
+server_group	= "miav"
+
+server_root	= "/var/miav_files"
+
+frame_sequence	= "IPPPP"
+
+frame_quality	= 85
+
+encoding_threads = 1
+
+encoding_codec 	= "mpeg4"
+.SH FILES
+.I /etc/miav.conf
+.RS
+The system wide configuration file.
+.SH "SEE ALSO"
+.BR miav (1)
+.SH AUTHOR
+Bent Bisballe <deva at aasimon dot org>