mirror of
				https://git.proxmox.com/git/mirror_corosync
				synced 2025-11-04 01:35:08 +00:00 
			
		
		
		
	The _overview manpages are not actually commands and hence do not belong
into manpage section 8. Move corosync_overview to section 7
("Miscellaneous") and the other *_overview pages to section 3 as they
contain API documentation (cf. string(3) for precedence of
multi-function manpages).
Signed-off-by: Christoph Berg <myon@debian.org>
Reviewed-by: Jan Friesse <jfriesse@redhat.com>
		
	
			
		
			
				
	
	
		
			71 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			71 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
.\"/*
 | 
						|
.\" * Copyright (c) 2012 Red Hat, Inc.
 | 
						|
.\" *
 | 
						|
.\" * All rights reserved.
 | 
						|
.\" *
 | 
						|
.\" * Author: Jan Friesse (jfriesse@redhat.com)
 | 
						|
.\" *
 | 
						|
.\" * This software licensed under BSD license, the text of which follows:
 | 
						|
.\" *
 | 
						|
.\" * Redistribution and use in source and binary forms, with or without
 | 
						|
.\" * modification, are permitted provided that the following conditions are met:
 | 
						|
.\" *
 | 
						|
.\" * - Redistributions of source code must retain the above copyright notice,
 | 
						|
.\" *   this list of conditions and the following disclaimer.
 | 
						|
.\" * - Redistributions in binary form must reproduce the above copyright notice,
 | 
						|
.\" *   this list of conditions and the following disclaimer in the documentation
 | 
						|
.\" *   and/or other materials provided with the distribution.
 | 
						|
.\" * - Neither the name of the Red Hat, Inc. nor the names of its
 | 
						|
.\" *   contributors may be used to endorse or promote products derived from this
 | 
						|
.\" *   software without specific prior written permission.
 | 
						|
.\" *
 | 
						|
.\" * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 | 
						|
.\" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 | 
						|
.\" * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 | 
						|
.\" * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
 | 
						|
.\" * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 | 
						|
.\" * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 | 
						|
.\" * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 | 
						|
.\" * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 | 
						|
.\" * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 | 
						|
.\" * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 | 
						|
.\" * THE POSSIBILITY OF SUCH DAMAGE.
 | 
						|
.\" */
 | 
						|
.TH "CMAP_DELETE" 3 "03/02/2012" "corosync Man Page" "Corosync Cluster Engine Programmer's Manual"
 | 
						|
 | 
						|
.SH NAME
 | 
						|
.P
 | 
						|
cmap_delete \- Delete key/value pair from the CMAP service
 | 
						|
 | 
						|
.SH SYNOPSIS
 | 
						|
.P
 | 
						|
\fB#include <corosync/cmap.h>\fR
 | 
						|
 | 
						|
.P
 | 
						|
\fBcs_error_t
 | 
						|
cmap_delete(cmap_handle_t \fIhandle\fB, const char *\fIkey_name\fB);\fR
 | 
						|
 | 
						|
.SH DESCRIPTION
 | 
						|
.P
 | 
						|
The
 | 
						|
.B cmap_delete
 | 
						|
function is used to delete key from cmap. Key must be previously created by
 | 
						|
.B cmap_set(3)
 | 
						|
function. The
 | 
						|
.I handle
 | 
						|
argument is connection to CMAP database obtained by calling
 | 
						|
.B cmap_initialize(3)
 | 
						|
function.
 | 
						|
.I key_name
 | 
						|
is name of key to delete.
 | 
						|
 | 
						|
.SH RETURN VALUE
 | 
						|
This call returns the CS_OK value if successful. If key_name is unspecified, CS_ERR_INVALID_PARAM
 | 
						|
is returned. For nonexisting keys, CS_ERR_NOT_EXIST error is returned. Some of keys may be tagged
 | 
						|
read-only directly in corosync and deleting such key will result in CS_ERR_ACCESS error.
 | 
						|
 | 
						|
.SH "SEE ALSO"
 | 
						|
.BR cmap_initialize (3),
 | 
						|
.BR cmap_set (3),
 | 
						|
.BR cmap_overview (3)
 |