ib_cache.h 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118
  1. /*
  2. * Copyright (c) 2004 Topspin Communications. All rights reserved.
  3. * Copyright (c) 2005 Intel Corporation. All rights reserved.
  4. * Copyright (c) 2005 Sun Microsystems, Inc. All rights reserved.
  5. *
  6. * This software is available to you under a choice of one of two
  7. * licenses. You may choose to be licensed under the terms of the GNU
  8. * General Public License (GPL) Version 2, available from the file
  9. * COPYING in the main directory of this source tree, or the
  10. * OpenIB.org BSD license below:
  11. *
  12. * Redistribution and use in source and binary forms, with or
  13. * without modification, are permitted provided that the following
  14. * conditions are met:
  15. *
  16. * - Redistributions of source code must retain the above
  17. * copyright notice, this list of conditions and the following
  18. * disclaimer.
  19. *
  20. * - Redistributions in binary form must reproduce the above
  21. * copyright notice, this list of conditions and the following
  22. * disclaimer in the documentation and/or other materials
  23. * provided with the distribution.
  24. *
  25. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  26. * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  27. * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  28. * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  29. * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  30. * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  31. * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  32. * SOFTWARE.
  33. *
  34. * $Id: ib_cache.h,v 1.1.1.1 2007/06/12 07:27:15 eyryu Exp $
  35. */
  36. #ifndef _IB_CACHE_H
  37. #define _IB_CACHE_H
  38. #include <rdma/ib_verbs.h>
  39. /**
  40. * ib_get_cached_gid - Returns a cached GID table entry
  41. * @device: The device to query.
  42. * @port_num: The port number of the device to query.
  43. * @index: The index into the cached GID table to query.
  44. * @gid: The GID value found at the specified index.
  45. *
  46. * ib_get_cached_gid() fetches the specified GID table entry stored in
  47. * the local software cache.
  48. */
  49. int ib_get_cached_gid(struct ib_device *device,
  50. u8 port_num,
  51. int index,
  52. union ib_gid *gid);
  53. /**
  54. * ib_find_cached_gid - Returns the port number and GID table index where
  55. * a specified GID value occurs.
  56. * @device: The device to query.
  57. * @gid: The GID value to search for.
  58. * @port_num: The port number of the device where the GID value was found.
  59. * @index: The index into the cached GID table where the GID was found. This
  60. * parameter may be NULL.
  61. *
  62. * ib_find_cached_gid() searches for the specified GID value in
  63. * the local software cache.
  64. */
  65. int ib_find_cached_gid(struct ib_device *device,
  66. union ib_gid *gid,
  67. u8 *port_num,
  68. u16 *index);
  69. /**
  70. * ib_get_cached_pkey - Returns a cached PKey table entry
  71. * @device: The device to query.
  72. * @port_num: The port number of the device to query.
  73. * @index: The index into the cached PKey table to query.
  74. * @pkey: The PKey value found at the specified index.
  75. *
  76. * ib_get_cached_pkey() fetches the specified PKey table entry stored in
  77. * the local software cache.
  78. */
  79. int ib_get_cached_pkey(struct ib_device *device_handle,
  80. u8 port_num,
  81. int index,
  82. u16 *pkey);
  83. /**
  84. * ib_find_cached_pkey - Returns the PKey table index where a specified
  85. * PKey value occurs.
  86. * @device: The device to query.
  87. * @port_num: The port number of the device to search for the PKey.
  88. * @pkey: The PKey value to search for.
  89. * @index: The index into the cached PKey table where the PKey was found.
  90. *
  91. * ib_find_cached_pkey() searches the specified PKey table in
  92. * the local software cache.
  93. */
  94. int ib_find_cached_pkey(struct ib_device *device,
  95. u8 port_num,
  96. u16 pkey,
  97. u16 *index);
  98. /**
  99. * ib_get_cached_lmc - Returns a cached lmc table entry
  100. * @device: The device to query.
  101. * @port_num: The port number of the device to query.
  102. * @lmc: The lmc value for the specified port for that device.
  103. *
  104. * ib_get_cached_lmc() fetches the specified lmc table entry stored in
  105. * the local software cache.
  106. */
  107. int ib_get_cached_lmc(struct ib_device *device,
  108. u8 port_num,
  109. u8 *lmc);
  110. #endif /* _IB_CACHE_H */