.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "ELEKTRA\-KEY\-NAMES" "7" "2015-11-19" "" ""
.
.SH "NAME"
\fBelektra\-key\-names\fR \- the names of keys
.
.P
Every \fBKey\fR object with the same name will receive the very same information from the global key database\. The name locates a \fBunique key\fR in the key database\. Key names are always absolute; so no parent or other information is needed\. That makes a \fBKey\fR self\-contained and independent both in memory and storage\.
.
.P
Every key name starts with a namespace \fIelektra\-namespaces\.md\fR, for example \fBuser\fR or \fBsystem\fR\. These prefixes spawn key hierarchies each\.
.
.P
The shared \fIsystem configuration\fR is identical for every user\. It contains, for example, information about system daemons, network related preferences and default settings for software\. These keys are created when software is installed, and removed when software is purged\. Only the administrator can change system configuration\.
.
.P
Examples of valid system key names:
.
.IP "" 4
.
.nf

system
system/hosts/hostname
system/sw/apache/httpd/num_processes
system/sw/apps/abc/current/default\-setting
.
.fi
.
.IP "" 0
.
.P
user configuration is empty until the user changes some preferences\. User configuration affects only a single user\. The user\'s settings can contain information about the user\'s environment, preferred applications and anything not useful for the rest of the system\.
.
.P
Examples of valid user key names:
.
.IP "" 4
.
.nf

user
user/env/#1/LD_LIBRARY_PATH
user/sw/apps/abc/current/default\-setting
user/sw/kde/kicker/preferred_applications/#1
.
.fi
.
.IP "" 0
.
.P
The slash (\fB/\fR) separates key names and structures them hierarchically\. If two keys start with the same key names, but one key name continues after a slash, this key is \fBbelow\fR the other and is called a \fIsubkey\fR\. For example \fBuser/sw/apps/abc/current\fR is a subkey of the key \fBuser/sw/apps\fR\. The key is not directly below but, for example, \fBuser/sw/apps/abc\fR is\. \fBkeyRel()\fR implements a way to decide the relation between two keys\.