.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "KDB\-SETMETA" "1" "2015-11-19" "" ""
.
.SH "NAME"
\fBkdb\-setmeta\fR \- Set the value of a meta key
.
.SH "SYNOPSIS"
\fBkdb setmeta <key\-name> <meta\-name> <meta\-value>\fR
.
.P
Where \fBkey\-name\fR is the path to the key that the meta key is associated with, \fBmeta\-name\fR is the name of the meta key the user would like to set the value of (or create), and \fBmeta\-value\fR is the value the user wishes to set the meta key to\.
.
.SH "DESCRIPTION"
This command allows the user to set the value of an individual meta key\. If a key does not already exist and the user tries setting a meta key associated with it, the key will be created with a null value\. There is some special handling for the meta data atime, mtime and ctime\. They will be converted to time_t\.
.
.P
For cascading keys, the namespace will default to \fBspec\fR, because that is the place where you usually want to set meta data\.
.
.SH "OPTIONS"
.
.TP
\fB\-H\fR, \fB\-\-help\fR
Show the man page\.
.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version info\.
.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Explain what is happening\.
.
.SH "EXAMPLES"
To set a meta key called \fBdescription\fR associated with the key \fBuser/example/key\fR to the value \fBHello World!\fR:
.
.br
\fBkdb setmeta spec/example/key description "Hello World!"\fR
.
.P
To create a new key \fBspec/example/newkey\fR with a null value (if it did not exist before) and a meta key \fBnamespace/#0\fR associated with it to the value \fBsystem\fR: \fBkdb setmeta /example/newkey "namespace/#0" system\fR
.
.SH "SEE ALSO"
.
.IP "\(bu" 4
How to get meta data: kdb\-getmeta(1) \fIkdb\-getmeta\.md\fR
.
.IP "\(bu" 4
elektra\-meta\-data(7) \fIelektra\-meta\-data\.md\fR
.
.IP "" 0