.TH COSD 8
.SH NAME
cosd \- ceph object storage daemon
.SH SYNOPSIS
.B cosd
\fB\-i \fIosdnum\fR
[ \fB\-\-osd\-data \fIdatapath\fR ]
[ \fB\-\-osd\-journal \fIjournal\fR ]
[ \fB\-\-mkfs\fR ]
[ \fB\-\-mkjournal\fR ]
[ \fB\-\-mkkey\fR ]
.SH DESCRIPTION
.B cosd
is the object storage daemon for the Ceph distributed file system.
It is responsible for storing objects on a local file system and 
providing access to them over the network.
.PP
The \fIdatapath\fP argument should be a directory on a btrfs file
system where the object data resides.  The \fIjournal\fP is optional,
and is only useful performance-wise when it resides on a different
disk than \fIdatapath\fP with low latency (ideally, an NVRAM device).
.SH OPTIONS
.TP
\fB\-f\fP, \fB\-\-foreground\fP
Foreground: do not daemonize after startup (run in foreground).
Do not generate a pid file. Useful when run via crun (8).
.TP
\fB\-d\fP
Debug mode: like -f, but also send all log output to stderr.
.TP
\fB\-\-osd\-data \fIosddata\fP
Use object store at \fIosddata\fP.
.TP
\fB\-\-osd\-journal \fIjournal\fP
Journal updates to \fIjournal\fP.
.TP
\fB\-\-mkfs\fP
Create an empty object repository.  Normally invoked by
.BR mkcephfs
(8).  This also initializes the jouranl (if one is defined).
.TP
\fB\-\-mkkey\fP
Generate a new secret key.  This is normally used in combination with \fB\-\-mkfs\fR 
as it is more convenient than generating a key by hand with \fIcauthtool\fR.
.TP
\fB\-\-mkjournal\fP
Create a new journal file to match an existing object repository.  This is useful if the journal
device or file is wiped out due to a disk or file system failure.
.TP
\fB\-\-flush-journal
Flush the journal to permanent store. This runs in the foreground so you
know when it's completed.
This can be useful if you want to resize the journal or need to otherwise
destroy it: this guarantees you won't lose data.
.TP
\fB\-c\fI ceph.conf\fR, \fB\-\-conf=\fIceph.conf\fR
Use \fIceph.conf\fP configuration file instead of the default \fI/etc/ceph/ceph.conf\fP
for runtime configuration options.
.TP
\fB\-m\fI monaddress[:port]\fR
Connect to specified monitor (instead of looking through \fIceph.conf\fR).
.SH AVAILABILITY
.B cosd
is part of the Ceph distributed file system.  Please refer to the Ceph wiki at
http://ceph.newdream.net/wiki for more information.
.SH SEE ALSO
.BR ceph (8),
.BR cmds (8),
.BR cmon (8),
.BR cauthtool (8)