votequorum_qdevice_getinfo.3.in 2.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
  1. .\"/*
  2. .\" * Copyright (c) 2009,2012 Red Hat, Inc.
  3. .\" *
  4. .\" * All rights reserved.
  5. .\" *
  6. .\" * Author: Christine Caulfield <ccaulfie@redhat.com>
  7. .\" *
  8. .\" * This software licensed under BSD license, the text of which follows:
  9. .\" *
  10. .\" * Redistribution and use in source and binary forms, with or without
  11. .\" * modification, are permitted provided that the following conditions are met:
  12. .\" *
  13. .\" * - Redistributions of source code must retain the above copyright notice,
  14. .\" * this list of conditions and the following disclaimer.
  15. .\" * - Redistributions in binary form must reproduce the above copyright notice,
  16. .\" * this list of conditions and the following disclaimer in the documentation
  17. .\" * and/or other materials provided with the distribution.
  18. .\" * - Neither the name of the MontaVista Software, Inc. nor the names of its
  19. .\" * contributors may be used to endorse or promote products derived from this
  20. .\" * software without specific prior written permission.
  21. .\" *
  22. .\" * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  23. .\" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24. .\" * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25. .\" * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  26. .\" * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  27. .\" * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  28. .\" * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  29. .\" * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  30. .\" * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  31. .\" * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
  32. .\" * THE POSSIBILITY OF SUCH DAMAGE.
  33. .\" */
  34. .TH VOTEQUORUM_QDEVICE_GETINFO 3 2012-01-27 "corosync Man Page" "Corosync Cluster Engine Programmer's Manual"
  35. .SH NAME
  36. votequorum_qdevice_getinfo \- Get details of the quorum device
  37. .SH SYNOPSIS
  38. .B #include <corosync/votequorum.h>
  39. .sp
  40. .BI "int votequorum_qdevice_getinfo(votequorum_handle_t " handle ", struct votequorum_qdevice_info " *info ");"
  41. .SH DESCRIPTION
  42. The
  43. .B votequorum_qdevice_getinfo
  44. Returns information about the quorum device in the following structure:
  45. .PP
  46. .PP
  47. .IP
  48. .RS
  49. .ne 18
  50. .nf
  51. .ta 4n 20n 32n
  52. struct votequorum_qdevice_info {
  53. unsigned int votes;
  54. unsigned int state;
  55. char name[VOTEQUORUM_MAX_QDEVICE_NAME_LEN];
  56. };
  57. .ta
  58. .fi
  59. .RE
  60. .IP
  61. .PP
  62. .PP
  63. .SH RETURN VALUE
  64. This call returns the CS_OK value if successful, otherwise an error is returned.
  65. .PP
  66. .SH ERRORS
  67. The errors are undocumented.
  68. .SH "SEE ALSO"
  69. .BR votequorum_overview (8),
  70. .BR votequorum_initialize (3),
  71. .BR votequorum_finalize (3),
  72. .BR votequorum_dispatch (3),
  73. .BR votequorum_fd_get (3),
  74. .BR votequorum_qdevice_poll (3),
  75. .BR votequorum_qdevice_unregister (3),
  76. .BR votequorum_qdevice_getinfo (3),
  77. .PP