xref: /freebsd/sys/dev/mps/mps_mapping.c (revision ef36b3f75658d201edb495068db5e1be49593de5)
1 /*-
2  * Copyright (c) 2011-2015 LSI Corp.
3  * Copyright (c) 2013-2015 Avago Technologies
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25  * SUCH DAMAGE.
26  *
27  * Avago Technologies (LSI) MPT-Fusion Host Adapter FreeBSD
28  */
29 
30 #include <sys/cdefs.h>
31 __FBSDID("$FreeBSD$");
32 
33 /* TODO Move headers to mpsvar */
34 #include <sys/types.h>
35 #include <sys/param.h>
36 #include <sys/lock.h>
37 #include <sys/mutex.h>
38 #include <sys/systm.h>
39 #include <sys/kernel.h>
40 #include <sys/malloc.h>
41 #include <sys/kthread.h>
42 #include <sys/taskqueue.h>
43 #include <sys/bus.h>
44 #include <sys/endian.h>
45 #include <sys/sysctl.h>
46 #include <sys/sbuf.h>
47 #include <sys/eventhandler.h>
48 #include <sys/uio.h>
49 #include <machine/bus.h>
50 #include <machine/resource.h>
51 #include <dev/mps/mpi/mpi2_type.h>
52 #include <dev/mps/mpi/mpi2.h>
53 #include <dev/mps/mpi/mpi2_ioc.h>
54 #include <dev/mps/mpi/mpi2_sas.h>
55 #include <dev/mps/mpi/mpi2_cnfg.h>
56 #include <dev/mps/mpi/mpi2_init.h>
57 #include <dev/mps/mpi/mpi2_tool.h>
58 #include <dev/mps/mps_ioctl.h>
59 #include <dev/mps/mpsvar.h>
60 #include <dev/mps/mps_mapping.h>
61 
62 /**
63  * _mapping_clear_map_entry - Clear a particular mapping entry.
64  * @map_entry: map table entry
65  *
66  * Returns nothing.
67  */
68 static inline void
69 _mapping_clear_map_entry(struct dev_mapping_table *map_entry)
70 {
71 	map_entry->physical_id = 0;
72 	map_entry->device_info = 0;
73 	map_entry->phy_bits = 0;
74 	map_entry->dpm_entry_num = MPS_DPM_BAD_IDX;
75 	map_entry->dev_handle = 0;
76 	map_entry->id = -1;
77 	map_entry->missing_count = 0;
78 	map_entry->init_complete = 0;
79 	map_entry->TLR_bits = (u8)MPI2_SCSIIO_CONTROL_NO_TLR;
80 }
81 
82 /**
83  * _mapping_clear_enc_entry - Clear a particular enclosure table entry.
84  * @enc_entry: enclosure table entry
85  *
86  * Returns nothing.
87  */
88 static inline void
89 _mapping_clear_enc_entry(struct enc_mapping_table *enc_entry)
90 {
91 	enc_entry->enclosure_id = 0;
92 	enc_entry->start_index = MPS_MAPTABLE_BAD_IDX;
93 	enc_entry->phy_bits = 0;
94 	enc_entry->dpm_entry_num = MPS_DPM_BAD_IDX;
95 	enc_entry->enc_handle = 0;
96 	enc_entry->num_slots = 0;
97 	enc_entry->start_slot = 0;
98 	enc_entry->missing_count = 0;
99 	enc_entry->removal_flag = 0;
100 	enc_entry->skip_search = 0;
101 	enc_entry->init_complete = 0;
102 }
103 
104 /**
105  * _mapping_commit_enc_entry - write a particular enc entry in DPM page0.
106  * @sc: per adapter object
107  * @enc_entry: enclosure table entry
108  *
109  * Returns 0 for success, non-zero for failure.
110  */
111 static int
112 _mapping_commit_enc_entry(struct mps_softc *sc,
113     struct enc_mapping_table *et_entry)
114 {
115 	Mpi2DriverMap0Entry_t *dpm_entry;
116 	struct dev_mapping_table *mt_entry;
117 	Mpi2ConfigReply_t mpi_reply;
118 	Mpi2DriverMappingPage0_t config_page;
119 
120 	if (!sc->is_dpm_enable)
121 		return 0;
122 
123 	memset(&config_page, 0, sizeof(Mpi2DriverMappingPage0_t));
124 	memcpy(&config_page.Header, (u8 *) sc->dpm_pg0,
125 	    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
126 	dpm_entry = (Mpi2DriverMap0Entry_t *)((u8 *)sc->dpm_pg0 +
127 	    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
128 	dpm_entry += et_entry->dpm_entry_num;
129 	dpm_entry->PhysicalIdentifier.Low =
130 	    ( 0xFFFFFFFF & et_entry->enclosure_id);
131 	dpm_entry->PhysicalIdentifier.High =
132 	    ( et_entry->enclosure_id >> 32);
133 	mt_entry = &sc->mapping_table[et_entry->start_index];
134 	dpm_entry->DeviceIndex = htole16(mt_entry->id);
135 	dpm_entry->MappingInformation = et_entry->num_slots;
136 	dpm_entry->MappingInformation <<= MPI2_DRVMAP0_MAPINFO_SLOT_SHIFT;
137 	dpm_entry->MappingInformation |= et_entry->missing_count;
138 	dpm_entry->MappingInformation = htole16(dpm_entry->MappingInformation);
139 	dpm_entry->PhysicalBitsMapping = htole32(et_entry->phy_bits);
140 	dpm_entry->Reserved1 = 0;
141 
142 	mps_dprint(sc, MPS_MAPPING, "%s: Writing DPM entry %d for enclosure.\n",
143 	    __func__, et_entry->dpm_entry_num);
144 	memcpy(&config_page.Entry, (u8 *)dpm_entry,
145 	    sizeof(Mpi2DriverMap0Entry_t));
146 	if (mps_config_set_dpm_pg0(sc, &mpi_reply, &config_page,
147 	    et_entry->dpm_entry_num)) {
148 		mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: Write of DPM "
149 		    "entry %d for enclosure failed.\n", __func__,
150 		    et_entry->dpm_entry_num);
151 		dpm_entry->MappingInformation = le16toh(dpm_entry->
152 		    MappingInformation);
153 		dpm_entry->DeviceIndex = le16toh(dpm_entry->DeviceIndex);
154 		dpm_entry->PhysicalBitsMapping =
155 		    le32toh(dpm_entry->PhysicalBitsMapping);
156 		return -1;
157 	}
158 	dpm_entry->MappingInformation = le16toh(dpm_entry->
159 	    MappingInformation);
160 	dpm_entry->DeviceIndex = le16toh(dpm_entry->DeviceIndex);
161 	dpm_entry->PhysicalBitsMapping =
162 	    le32toh(dpm_entry->PhysicalBitsMapping);
163 	return 0;
164 }
165 
166 /**
167  * _mapping_commit_map_entry - write a particular map table entry in DPM page0.
168  * @sc: per adapter object
169  * @mt_entry: mapping table entry
170  *
171  * Returns 0 for success, non-zero for failure.
172  */
173 
174 static int
175 _mapping_commit_map_entry(struct mps_softc *sc,
176     struct dev_mapping_table *mt_entry)
177 {
178 	Mpi2DriverMap0Entry_t *dpm_entry;
179 	Mpi2ConfigReply_t mpi_reply;
180 	Mpi2DriverMappingPage0_t config_page;
181 
182 	if (!sc->is_dpm_enable)
183 		return 0;
184 
185 	/*
186 	 * It's possible that this Map Entry points to a BAD DPM index. This
187 	 * can happen if the Map Entry is a for a missing device and the DPM
188 	 * entry that was being used by this device is now being used by some
189 	 * new device. So, check for a BAD DPM index and just return if so.
190 	 */
191 	if (mt_entry->dpm_entry_num == MPS_DPM_BAD_IDX) {
192 		mps_dprint(sc, MPS_MAPPING, "%s: DPM entry location for target "
193 		    "%d is invalid. DPM will not be written.\n", __func__,
194 		    mt_entry->id);
195 		return 0;
196 	}
197 
198 	memset(&config_page, 0, sizeof(Mpi2DriverMappingPage0_t));
199 	memcpy(&config_page.Header, (u8 *)sc->dpm_pg0,
200 	    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
201 	dpm_entry = (Mpi2DriverMap0Entry_t *)((u8 *) sc->dpm_pg0 +
202 	    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
203 	dpm_entry = dpm_entry + mt_entry->dpm_entry_num;
204 	dpm_entry->PhysicalIdentifier.Low = (0xFFFFFFFF &
205 	    mt_entry->physical_id);
206 	dpm_entry->PhysicalIdentifier.High = (mt_entry->physical_id >> 32);
207 	dpm_entry->DeviceIndex = htole16(mt_entry->id);
208 	dpm_entry->MappingInformation = htole16(mt_entry->missing_count);
209 	dpm_entry->PhysicalBitsMapping = 0;
210 	dpm_entry->Reserved1 = 0;
211 	memcpy(&config_page.Entry, (u8 *)dpm_entry,
212 	    sizeof(Mpi2DriverMap0Entry_t));
213 
214 	mps_dprint(sc, MPS_MAPPING, "%s: Writing DPM entry %d for target %d.\n",
215 	    __func__, mt_entry->dpm_entry_num, mt_entry->id);
216 	if (mps_config_set_dpm_pg0(sc, &mpi_reply, &config_page,
217 	    mt_entry->dpm_entry_num)) {
218 		mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: Write of DPM "
219 		    "entry %d for target %d failed.\n", __func__,
220 		    mt_entry->dpm_entry_num, mt_entry->id);
221 		dpm_entry->MappingInformation = le16toh(dpm_entry->
222 		    MappingInformation);
223 		dpm_entry->DeviceIndex = le16toh(dpm_entry->DeviceIndex);
224 		return -1;
225 	}
226 
227 	dpm_entry->MappingInformation = le16toh(dpm_entry->MappingInformation);
228 	dpm_entry->DeviceIndex = le16toh(dpm_entry->DeviceIndex);
229 	return 0;
230 }
231 
232 /**
233  * _mapping_get_ir_maprange - get start and end index for IR map range.
234  * @sc: per adapter object
235  * @start_idx: place holder for start index
236  * @end_idx: place holder for end index
237  *
238  * The IR volumes can be mapped either at start or end of the mapping table
239  * this function gets the detail of where IR volume mapping starts and ends
240  * in the device mapping table
241  *
242  * Returns nothing.
243  */
244 static void
245 _mapping_get_ir_maprange(struct mps_softc *sc, u32 *start_idx, u32 *end_idx)
246 {
247 	u16 volume_mapping_flags;
248 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
249 
250 	volume_mapping_flags = le16toh(sc->ioc_pg8.IRVolumeMappingFlags) &
251 	    MPI2_IOCPAGE8_IRFLAGS_MASK_VOLUME_MAPPING_MODE;
252 	if (volume_mapping_flags == MPI2_IOCPAGE8_IRFLAGS_LOW_VOLUME_MAPPING) {
253 		*start_idx = 0;
254 		if (ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_RESERVED_TARGETID_0)
255 			*start_idx = 1;
256 	} else
257 		*start_idx = sc->max_devices - sc->max_volumes;
258 	*end_idx = *start_idx + sc->max_volumes - 1;
259 }
260 
261 /**
262  * _mapping_get_enc_idx_from_id - get enclosure index from enclosure ID
263  * @sc: per adapter object
264  * @enc_id: enclosure logical identifier
265  *
266  * Returns the index of enclosure entry on success or bad index.
267  */
268 static u8
269 _mapping_get_enc_idx_from_id(struct mps_softc *sc, u64 enc_id,
270     u64 phy_bits)
271 {
272 	struct enc_mapping_table *et_entry;
273 	u8 enc_idx = 0;
274 
275 	for (enc_idx = 0; enc_idx < sc->num_enc_table_entries; enc_idx++) {
276 		et_entry = &sc->enclosure_table[enc_idx];
277 		if ((et_entry->enclosure_id == le64toh(enc_id)) &&
278 		    (!et_entry->phy_bits || (et_entry->phy_bits &
279 		    le32toh(phy_bits))))
280 			return enc_idx;
281 	}
282 	return MPS_ENCTABLE_BAD_IDX;
283 }
284 
285 /**
286  * _mapping_get_enc_idx_from_handle - get enclosure index from handle
287  * @sc: per adapter object
288  * @enc_id: enclosure handle
289  *
290  * Returns the index of enclosure entry on success or bad index.
291  */
292 static u8
293 _mapping_get_enc_idx_from_handle(struct mps_softc *sc, u16 handle)
294 {
295 	struct enc_mapping_table *et_entry;
296 	u8 enc_idx = 0;
297 
298 	for (enc_idx = 0; enc_idx < sc->num_enc_table_entries; enc_idx++) {
299 		et_entry = &sc->enclosure_table[enc_idx];
300 		if (et_entry->missing_count)
301 			continue;
302 		if (et_entry->enc_handle == handle)
303 			return enc_idx;
304 	}
305 	return MPS_ENCTABLE_BAD_IDX;
306 }
307 
308 /**
309  * _mapping_get_high_missing_et_idx - get missing enclosure index
310  * @sc: per adapter object
311  *
312  * Search through the enclosure table and identifies the enclosure entry
313  * with high missing count and returns it's index
314  *
315  * Returns the index of enclosure entry on success or bad index.
316  */
317 static u8
318 _mapping_get_high_missing_et_idx(struct mps_softc *sc)
319 {
320 	struct enc_mapping_table *et_entry;
321 	u8 high_missing_count = 0;
322 	u8 enc_idx, high_idx = MPS_ENCTABLE_BAD_IDX;
323 
324 	for (enc_idx = 0; enc_idx < sc->num_enc_table_entries; enc_idx++) {
325 		et_entry = &sc->enclosure_table[enc_idx];
326 		if ((et_entry->missing_count > high_missing_count) &&
327 		    !et_entry->skip_search) {
328 			high_missing_count = et_entry->missing_count;
329 			high_idx = enc_idx;
330 		}
331 	}
332 	return high_idx;
333 }
334 
335 /**
336  * _mapping_get_high_missing_mt_idx - get missing map table index
337  * @sc: per adapter object
338  *
339  * Search through the map table and identifies the device entry
340  * with high missing count and returns it's index
341  *
342  * Returns the index of map table entry on success or bad index.
343  */
344 static u32
345 _mapping_get_high_missing_mt_idx(struct mps_softc *sc)
346 {
347 	u32 map_idx, high_idx = MPS_MAPTABLE_BAD_IDX;
348 	u8 high_missing_count = 0;
349 	u32 start_idx, end_idx, start_idx_ir, end_idx_ir;
350 	struct dev_mapping_table *mt_entry;
351 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
352 
353 	start_idx = 0;
354 	start_idx_ir = 0;
355 	end_idx_ir = 0;
356 	end_idx = sc->max_devices;
357 	if (ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_RESERVED_TARGETID_0)
358 		start_idx = 1;
359 	if (sc->ir_firmware) {
360 		_mapping_get_ir_maprange(sc, &start_idx_ir, &end_idx_ir);
361 		if (start_idx == start_idx_ir)
362 			start_idx = end_idx_ir + 1;
363 		else
364 			end_idx = start_idx_ir;
365 	}
366 	mt_entry = &sc->mapping_table[start_idx];
367 	for (map_idx = start_idx; map_idx < end_idx; map_idx++, mt_entry++) {
368 		if (mt_entry->missing_count > high_missing_count) {
369 			high_missing_count =  mt_entry->missing_count;
370 			high_idx = map_idx;
371 		}
372 	}
373 	return high_idx;
374 }
375 
376 /**
377  * _mapping_get_ir_mt_idx_from_wwid - get map table index from volume WWID
378  * @sc: per adapter object
379  * @wwid: world wide unique ID of the volume
380  *
381  * Returns the index of map table entry on success or bad index.
382  */
383 static u32
384 _mapping_get_ir_mt_idx_from_wwid(struct mps_softc *sc, u64 wwid)
385 {
386 	u32 start_idx, end_idx, map_idx;
387 	struct dev_mapping_table *mt_entry;
388 
389 	_mapping_get_ir_maprange(sc, &start_idx, &end_idx);
390 	mt_entry = &sc->mapping_table[start_idx];
391 	for (map_idx = start_idx; map_idx <= end_idx; map_idx++, mt_entry++)
392 		if (mt_entry->physical_id == wwid)
393 			return map_idx;
394 
395 	return MPS_MAPTABLE_BAD_IDX;
396 }
397 
398 /**
399  * _mapping_get_mt_idx_from_id - get map table index from a device ID
400  * @sc: per adapter object
401  * @dev_id: device identifer (SAS Address)
402  *
403  * Returns the index of map table entry on success or bad index.
404  */
405 static u32
406 _mapping_get_mt_idx_from_id(struct mps_softc *sc, u64 dev_id)
407 {
408 	u32 map_idx;
409 	struct dev_mapping_table *mt_entry;
410 
411 	for (map_idx = 0; map_idx < sc->max_devices; map_idx++) {
412 		mt_entry = &sc->mapping_table[map_idx];
413 		if (mt_entry->physical_id == dev_id)
414 			return map_idx;
415 	}
416 	return MPS_MAPTABLE_BAD_IDX;
417 }
418 
419 /**
420  * _mapping_get_ir_mt_idx_from_handle - get map table index from volume handle
421  * @sc: per adapter object
422  * @wwid: volume device handle
423  *
424  * Returns the index of map table entry on success or bad index.
425  */
426 static u32
427 _mapping_get_ir_mt_idx_from_handle(struct mps_softc *sc, u16 volHandle)
428 {
429 	u32 start_idx, end_idx, map_idx;
430 	struct dev_mapping_table *mt_entry;
431 
432 	_mapping_get_ir_maprange(sc, &start_idx, &end_idx);
433 	mt_entry = &sc->mapping_table[start_idx];
434 	for (map_idx = start_idx; map_idx <= end_idx; map_idx++, mt_entry++)
435 		if (mt_entry->dev_handle == volHandle)
436 			return map_idx;
437 
438 	return MPS_MAPTABLE_BAD_IDX;
439 }
440 
441 /**
442  * _mapping_get_mt_idx_from_handle - get map table index from handle
443  * @sc: per adapter object
444  * @dev_id: device handle
445  *
446  * Returns the index of map table entry on success or bad index.
447  */
448 static u32
449 _mapping_get_mt_idx_from_handle(struct mps_softc *sc, u16 handle)
450 {
451 	u32 map_idx;
452 	struct dev_mapping_table *mt_entry;
453 
454 	for (map_idx = 0; map_idx < sc->max_devices; map_idx++) {
455 		mt_entry = &sc->mapping_table[map_idx];
456 		if (mt_entry->dev_handle == handle)
457 			return map_idx;
458 	}
459 	return MPS_MAPTABLE_BAD_IDX;
460 }
461 
462 /**
463  * _mapping_get_free_ir_mt_idx - get first free index for a volume
464  * @sc: per adapter object
465  *
466  * Search through mapping table for free index for a volume and if no free
467  * index then looks for a volume with high mapping index
468  *
469  * Returns the index of map table entry on success or bad index.
470  */
471 static u32
472 _mapping_get_free_ir_mt_idx(struct mps_softc *sc)
473 {
474 	u8 high_missing_count = 0;
475 	u32 start_idx, end_idx, map_idx;
476 	u32 high_idx = MPS_MAPTABLE_BAD_IDX;
477 	struct dev_mapping_table *mt_entry;
478 
479 	/*
480 	 * The IN_USE flag should be clear if the entry is available to use.
481 	 * This flag is cleared on initialization and and when a volume is
482 	 * deleted. All other times this flag should be set. If, for some
483 	 * reason, a free entry cannot be found, look for the entry with the
484 	 * highest missing count just in case there is one.
485 	 */
486 	_mapping_get_ir_maprange(sc, &start_idx, &end_idx);
487 
488 	mt_entry = &sc->mapping_table[start_idx];
489 	for (map_idx = start_idx; map_idx <= end_idx; map_idx++, mt_entry++) {
490 		if (!(mt_entry->device_info & MPS_MAP_IN_USE))
491 			return map_idx;
492 
493 		if (mt_entry->missing_count > high_missing_count) {
494 			high_missing_count = mt_entry->missing_count;
495 			high_idx = map_idx;
496 		}
497 	}
498 
499 	if (high_idx == MPS_MAPTABLE_BAD_IDX) {
500 		mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: Could not find a "
501 		    "free entry in the mapping table for a Volume. The mapping "
502 		    "table is probably corrupt.\n", __func__);
503 	}
504 
505 	return high_idx;
506 }
507 
508 /**
509  * _mapping_get_free_mt_idx - get first free index for a device
510  * @sc: per adapter object
511  * @start_idx: offset in the table to start search
512  *
513  * Returns the index of map table entry on success or bad index.
514  */
515 static u32
516 _mapping_get_free_mt_idx(struct mps_softc *sc, u32 start_idx)
517 {
518 	u32 map_idx, max_idx = sc->max_devices;
519 	struct dev_mapping_table *mt_entry = &sc->mapping_table[start_idx];
520 	u16 volume_mapping_flags;
521 
522 	volume_mapping_flags = le16toh(sc->ioc_pg8.IRVolumeMappingFlags) &
523 	    MPI2_IOCPAGE8_IRFLAGS_MASK_VOLUME_MAPPING_MODE;
524 	if (sc->ir_firmware && (volume_mapping_flags ==
525 	    MPI2_IOCPAGE8_IRFLAGS_HIGH_VOLUME_MAPPING))
526 		max_idx -= sc->max_volumes;
527 
528 	for (map_idx  = start_idx; map_idx < max_idx; map_idx++, mt_entry++)
529 		if (!(mt_entry->device_info & (MPS_MAP_IN_USE |
530 		    MPS_DEV_RESERVED)))
531 			return map_idx;
532 
533 	return MPS_MAPTABLE_BAD_IDX;
534 }
535 
536 /**
537  * _mapping_get_dpm_idx_from_id - get DPM index from ID
538  * @sc: per adapter object
539  * @id: volume WWID or enclosure ID or device ID
540  *
541  * Returns the index of DPM entry on success or bad index.
542  */
543 static u16
544 _mapping_get_dpm_idx_from_id(struct mps_softc *sc, u64 id, u32 phy_bits)
545 {
546 	u16 entry_num;
547 	uint64_t PhysicalIdentifier;
548 	Mpi2DriverMap0Entry_t *dpm_entry;
549 
550 	dpm_entry = (Mpi2DriverMap0Entry_t *)((u8 *)sc->dpm_pg0 +
551 	    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
552 	PhysicalIdentifier = dpm_entry->PhysicalIdentifier.High;
553 	PhysicalIdentifier = (PhysicalIdentifier << 32) |
554 	    dpm_entry->PhysicalIdentifier.Low;
555 	for (entry_num = 0; entry_num < sc->max_dpm_entries; entry_num++,
556 	    dpm_entry++)
557 		if ((id == PhysicalIdentifier) &&
558 		    (!phy_bits || !dpm_entry->PhysicalBitsMapping ||
559 		    (phy_bits & dpm_entry->PhysicalBitsMapping)))
560 			return entry_num;
561 
562 	return MPS_DPM_BAD_IDX;
563 }
564 
565 
566 /**
567  * _mapping_get_free_dpm_idx - get first available DPM index
568  * @sc: per adapter object
569  *
570  * Returns the index of DPM entry on success or bad index.
571  */
572 static u32
573 _mapping_get_free_dpm_idx(struct mps_softc *sc)
574 {
575 	u16 entry_num;
576 	Mpi2DriverMap0Entry_t *dpm_entry;
577 	u16 current_entry = MPS_DPM_BAD_IDX, missing_cnt, high_missing_cnt = 0;
578 	u64 physical_id;
579 	struct dev_mapping_table *mt_entry;
580 	u32 map_idx;
581 
582  	for (entry_num = 0; entry_num < sc->max_dpm_entries; entry_num++) {
583 		dpm_entry = (Mpi2DriverMap0Entry_t *) ((u8 *)sc->dpm_pg0 +
584 		    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
585 		dpm_entry += entry_num;
586 		missing_cnt = dpm_entry->MappingInformation &
587 		    MPI2_DRVMAP0_MAPINFO_MISSING_MASK;
588 
589 		/*
590 		 * If entry is used and not missing, then this entry can't be
591 		 * used. Look at next one.
592 		 */
593 		if (sc->dpm_entry_used[entry_num] && !missing_cnt)
594 			continue;
595 
596 		/*
597 		 * If this entry is not used at all, then the missing count
598 		 * doesn't matter. Just use this one. Otherwise, keep looking
599 		 * and make sure the entry with the highest missing count is
600 		 * used.
601 		 */
602 		if (!sc->dpm_entry_used[entry_num]) {
603 			current_entry = entry_num;
604 			break;
605 		}
606 		if ((current_entry == MPS_DPM_BAD_IDX) ||
607 		    (missing_cnt > high_missing_cnt)) {
608 			current_entry = entry_num;
609 			high_missing_cnt = missing_cnt;
610 		}
611  	}
612 
613 	/*
614 	 * If an entry has been found to use and it's already marked as used
615 	 * it means that some device was already using this entry but it's
616 	 * missing, and that means that the connection between the missing
617 	 * device's DPM entry and the mapping table needs to be cleared. To do
618 	 * this, use the Physical ID of the old device still in the DPM entry
619 	 * to find its mapping table entry, then mark its DPM entry as BAD.
620 	 */
621 	if ((current_entry != MPS_DPM_BAD_IDX) &&
622 	    sc->dpm_entry_used[current_entry]) {
623 		dpm_entry = (Mpi2DriverMap0Entry_t *) ((u8 *)sc->dpm_pg0 +
624 		    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
625 		dpm_entry += current_entry;
626 		physical_id = dpm_entry->PhysicalIdentifier.High;
627 		physical_id = (physical_id << 32) |
628 		    dpm_entry->PhysicalIdentifier.Low;
629 		map_idx = _mapping_get_mt_idx_from_id(sc, physical_id);
630 		if (map_idx != MPS_MAPTABLE_BAD_IDX) {
631 			mt_entry = &sc->mapping_table[map_idx];
632 			mt_entry->dpm_entry_num = MPS_DPM_BAD_IDX;
633 		}
634 	}
635 	return current_entry;
636 }
637 
638 /**
639  * _mapping_update_ir_missing_cnt - Updates missing count for a volume
640  * @sc: per adapter object
641  * @map_idx: map table index of the volume
642  * @element: IR configuration change element
643  * @wwid: IR volume ID.
644  *
645  * Updates the missing count in the map table and in the DPM entry for a volume
646  *
647  * Returns nothing.
648  */
649 static void
650 _mapping_update_ir_missing_cnt(struct mps_softc *sc, u32 map_idx,
651     Mpi2EventIrConfigElement_t *element, u64 wwid)
652 {
653 	struct dev_mapping_table *mt_entry;
654 	u8 missing_cnt, reason = element->ReasonCode, update_dpm = 1;
655 	u16 dpm_idx;
656 	Mpi2DriverMap0Entry_t *dpm_entry;
657 
658 	/*
659 	 * Depending on the reason code, update the missing count. Always set
660 	 * the init_complete flag when here, so just do it first. That flag is
661 	 * used for volumes to make sure that the DPM entry has been updated.
662 	 * When a volume is deleted, clear the map entry's IN_USE flag so that
663 	 * the entry can be used again if another volume is created. Also clear
664 	 * its dev_handle entry so that other functions can't find this volume
665 	 * by the handle, since it's not defined any longer.
666 	 */
667 	mt_entry = &sc->mapping_table[map_idx];
668 	mt_entry->init_complete = 1;
669 	if ((reason == MPI2_EVENT_IR_CHANGE_RC_ADDED) ||
670 	    (reason == MPI2_EVENT_IR_CHANGE_RC_VOLUME_CREATED)) {
671 		mt_entry->missing_count = 0;
672 	} else if (reason == MPI2_EVENT_IR_CHANGE_RC_VOLUME_DELETED) {
673 		if (mt_entry->missing_count < MPS_MAX_MISSING_COUNT)
674 			mt_entry->missing_count++;
675 
676 		mt_entry->device_info &= ~MPS_MAP_IN_USE;
677 		mt_entry->dev_handle = 0;
678 	}
679 
680 	/*
681 	 * If persistent mapping is enabled, update the DPM with the new missing
682 	 * count for the volume. If the DPM index is bad, get a free one. If
683 	 * it's bad for a volume that's being deleted do nothing because that
684 	 * volume doesn't have a DPM entry.
685 	 */
686 	if (!sc->is_dpm_enable)
687 		return;
688 	dpm_idx = mt_entry->dpm_entry_num;
689 	if (dpm_idx == MPS_DPM_BAD_IDX) {
690 		if (reason == MPI2_EVENT_IR_CHANGE_RC_VOLUME_DELETED)
691 		{
692 			mps_dprint(sc, MPS_MAPPING, "%s: Volume being deleted "
693 			    "is not in DPM so DPM missing count will not be "
694 			    "updated.\n", __func__);
695 			return;
696 		}
697 	}
698 	if (dpm_idx == MPS_DPM_BAD_IDX)
699 		dpm_idx = _mapping_get_free_dpm_idx(sc);
700 
701 	/*
702 	 * Got the DPM entry for the volume or found a free DPM entry if this is
703 	 * a new volume. Check if the current information is outdated.
704 	 */
705 	if (dpm_idx != MPS_DPM_BAD_IDX) {
706 		dpm_entry = (Mpi2DriverMap0Entry_t *)((u8 *)sc->dpm_pg0 +
707 		    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
708 		dpm_entry += dpm_idx;
709 		missing_cnt = dpm_entry->MappingInformation &
710 		    MPI2_DRVMAP0_MAPINFO_MISSING_MASK;
711 		if ((mt_entry->physical_id ==
712 		    le64toh(((u64)dpm_entry->PhysicalIdentifier.High << 32) |
713 		    (u64)dpm_entry->PhysicalIdentifier.Low)) && (missing_cnt ==
714 		    mt_entry->missing_count)) {
715 			mps_dprint(sc, MPS_MAPPING, "%s: DPM entry for volume "
716 			   "with target ID %d does not require an update.\n",
717 			    __func__, mt_entry->id);
718 			update_dpm = 0;
719 		}
720 	}
721 
722 	/*
723 	 * Update the volume's persistent info if it's new or the ID or missing
724 	 * count has changed. If a good DPM index has not been found by now,
725 	 * there is no space left in the DPM table.
726 	 */
727 	if ((dpm_idx != MPS_DPM_BAD_IDX) && update_dpm) {
728 		mps_dprint(sc, MPS_MAPPING, "%s: Update DPM entry for volume "
729 		    "with target ID %d.\n", __func__, mt_entry->id);
730 
731 		mt_entry->dpm_entry_num = dpm_idx;
732 		dpm_entry = (Mpi2DriverMap0Entry_t *)((u8 *)sc->dpm_pg0 +
733 		    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
734 		dpm_entry += dpm_idx;
735 		dpm_entry->PhysicalIdentifier.Low =
736 		    (0xFFFFFFFF & mt_entry->physical_id);
737 		dpm_entry->PhysicalIdentifier.High =
738 		    (mt_entry->physical_id >> 32);
739 		dpm_entry->DeviceIndex = map_idx;
740 		dpm_entry->MappingInformation = mt_entry->missing_count;
741 		dpm_entry->PhysicalBitsMapping = 0;
742 		dpm_entry->Reserved1 = 0;
743 		sc->dpm_flush_entry[dpm_idx] = 1;
744 		sc->dpm_entry_used[dpm_idx] = 1;
745 	} else if (dpm_idx == MPS_DPM_BAD_IDX) {
746 		mps_dprint(sc, MPS_INFO | MPS_MAPPING, "%s: No space to add an "
747 		    "entry in the DPM table for volume with target ID %d.\n",
748 		    __func__, mt_entry->id);
749 	}
750 }
751 
752 /**
753  * _mapping_add_to_removal_table - add DPM index to the removal table
754  * @sc: per adapter object
755  * @dpm_idx: Index of DPM entry to remove
756  *
757  * Adds a DPM entry number to the removal table.
758  *
759  * Returns nothing.
760  */
761 static void
762 _mapping_add_to_removal_table(struct mps_softc *sc, u16 dpm_idx)
763 {
764 	struct map_removal_table *remove_entry;
765 	u32 i;
766 
767 	/*
768 	 * This is only used to remove entries from the DPM in the controller.
769 	 * If DPM is not enabled, just return.
770 	 */
771 	if (!sc->is_dpm_enable)
772 		return;
773 
774 	/*
775 	 * Find the first available removal_table entry and add the new entry
776 	 * there.
777 	 */
778 	remove_entry = sc->removal_table;
779 
780 	for (i = 0; i < sc->max_devices; i++, remove_entry++) {
781 		if (remove_entry->dpm_entry_num != MPS_DPM_BAD_IDX)
782 			continue;
783 
784 		mps_dprint(sc, MPS_MAPPING, "%s: Adding DPM entry %d to table "
785 		    "for removal.\n", __func__, dpm_idx);
786 		remove_entry->dpm_entry_num = dpm_idx;
787 		break;
788 	}
789 
790 }
791 
792 /**
793  * _mapping_update_missing_count - Update missing count for a device
794  * @sc: per adapter object
795  * @topo_change: Topology change event entry
796  *
797  * Increment the missing count in the mapping table for a device that is not
798  * responding. If Persitent Mapping is used, increment the DPM entry as well.
799  * Currently, this function only increments the missing count if the device
800  * goes missing, so after initialization has completed. This means that the
801  * missing count can only go from 0 to 1 here. The missing count is incremented
802  * during initialization as well, so that's where a target's missing count can
803  * go past 1.
804  *
805  * Returns nothing.
806  */
807 static void
808 _mapping_update_missing_count(struct mps_softc *sc,
809     struct _map_topology_change *topo_change)
810 {
811 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
812 	u8 entry;
813 	struct _map_phy_change *phy_change;
814 	u32 map_idx;
815 	struct dev_mapping_table *mt_entry;
816 	Mpi2DriverMap0Entry_t *dpm_entry;
817 
818 	for (entry = 0; entry < topo_change->num_entries; entry++) {
819 		phy_change = &topo_change->phy_details[entry];
820 		if (!phy_change->dev_handle || (phy_change->reason !=
821 		    MPI2_EVENT_SAS_TOPO_RC_TARG_NOT_RESPONDING))
822 			continue;
823 		map_idx = _mapping_get_mt_idx_from_handle(sc, phy_change->
824 		    dev_handle);
825 		phy_change->is_processed = 1;
826 		if (map_idx == MPS_MAPTABLE_BAD_IDX) {
827 			mps_dprint(sc, MPS_INFO | MPS_MAPPING, "%s: device is "
828 			    "already removed from mapping table\n", __func__);
829 			continue;
830 		}
831 		mt_entry = &sc->mapping_table[map_idx];
832 		if (mt_entry->missing_count < MPS_MAX_MISSING_COUNT)
833 			mt_entry->missing_count++;
834 
835 		/*
836 		 * When using Enc/Slot mapping, when a device is removed, it's
837 		 * mapping table information should be cleared. Otherwise, the
838 		 * target ID will be incorrect if this same device is re-added
839 		 * to a different slot.
840 		 */
841 		if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
842 		    MPI2_IOCPAGE8_FLAGS_ENCLOSURE_SLOT_MAPPING) {
843 			_mapping_clear_map_entry(mt_entry);
844 		}
845 
846 		/*
847 		 * When using device mapping, update the missing count in the
848 		 * DPM entry, but only if the missing count has changed.
849 		 */
850 		if (((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
851 		    MPI2_IOCPAGE8_FLAGS_DEVICE_PERSISTENCE_MAPPING) &&
852 		    sc->is_dpm_enable &&
853 		    mt_entry->dpm_entry_num != MPS_DPM_BAD_IDX) {
854 			dpm_entry =
855 			    (Mpi2DriverMap0Entry_t *) ((u8 *)sc->dpm_pg0 +
856 			    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
857 			dpm_entry += mt_entry->dpm_entry_num;
858 			if (dpm_entry->MappingInformation !=
859 			    mt_entry->missing_count) {
860 				dpm_entry->MappingInformation =
861 				    mt_entry->missing_count;
862 				sc->dpm_flush_entry[mt_entry->dpm_entry_num] =
863 				    1;
864 			}
865 		}
866 	}
867 }
868 
869 /**
870  * _mapping_find_enc_map_space -find map table entries for enclosure
871  * @sc: per adapter object
872  * @et_entry: enclosure entry
873  *
874  * Search through the mapping table defragment it and provide contiguous
875  * space in map table for a particular enclosure entry
876  *
877  * Returns start index in map table or bad index.
878  */
879 static u32
880 _mapping_find_enc_map_space(struct mps_softc *sc,
881     struct enc_mapping_table *et_entry)
882 {
883 	u16 vol_mapping_flags;
884 	u32 skip_count, end_of_table, map_idx, enc_idx;
885 	u16 num_found;
886 	u32 start_idx = MPS_MAPTABLE_BAD_IDX;
887 	struct dev_mapping_table *mt_entry;
888 	struct enc_mapping_table *enc_entry;
889 	unsigned char done_flag = 0, found_space;
890 	u16 max_num_phy_ids = le16toh(sc->ioc_pg8.MaxNumPhysicalMappedIDs);
891 
892 	skip_count = sc->num_rsvd_entries;
893 	num_found = 0;
894 
895 	vol_mapping_flags = le16toh(sc->ioc_pg8.IRVolumeMappingFlags) &
896 	    MPI2_IOCPAGE8_IRFLAGS_MASK_VOLUME_MAPPING_MODE;
897 
898 	/*
899 	 * The end of the mapping table depends on where volumes are kept, if
900 	 * IR is enabled.
901 	 */
902 	if (!sc->ir_firmware)
903 		end_of_table = sc->max_devices;
904 	else if (vol_mapping_flags == MPI2_IOCPAGE8_IRFLAGS_LOW_VOLUME_MAPPING)
905 		end_of_table = sc->max_devices;
906 	else
907 		end_of_table = sc->max_devices - sc->max_volumes;
908 
909 	/*
910 	 * The skip_count is the number of entries that are reserved at the
911 	 * beginning of the mapping table. But, it does not include the number
912 	 * of Physical IDs that are reserved for direct attached devices. Look
913 	 * through the mapping table after these reserved entries to see if
914 	 * the devices for this enclosure are already mapped. The PHY bit check
915 	 * is used to make sure that at least one PHY bit is common between the
916 	 * enclosure and the device that is already mapped.
917 	 */
918 	mps_dprint(sc, MPS_MAPPING, "%s: Looking for space in the mapping "
919 	    "table for added enclosure.\n", __func__);
920 	for (map_idx = (max_num_phy_ids + skip_count);
921 	    map_idx < end_of_table; map_idx++) {
922 		mt_entry = &sc->mapping_table[map_idx];
923 		if ((et_entry->enclosure_id == mt_entry->physical_id) &&
924 		    (!mt_entry->phy_bits || (mt_entry->phy_bits &
925 		    et_entry->phy_bits))) {
926 			num_found += 1;
927 			if (num_found == et_entry->num_slots) {
928 				start_idx = (map_idx - num_found) + 1;
929 				mps_dprint(sc, MPS_MAPPING, "%s: Found space "
930 				    "in the mapping for enclosure at map index "
931 				    "%d.\n", __func__, start_idx);
932 				return start_idx;
933 			}
934 		} else
935 			num_found = 0;
936 	}
937 
938 	/*
939 	 * If the enclosure's devices are not mapped already, look for
940 	 * contiguous entries in the mapping table that are not reserved. If
941 	 * enough entries are found, return the starting index for that space.
942 	 */
943 	num_found = 0;
944 	for (map_idx = (max_num_phy_ids + skip_count);
945 	    map_idx < end_of_table; map_idx++) {
946 		mt_entry = &sc->mapping_table[map_idx];
947 		if (!(mt_entry->device_info & MPS_DEV_RESERVED)) {
948 			num_found += 1;
949 			if (num_found == et_entry->num_slots) {
950 				start_idx = (map_idx - num_found) + 1;
951 				mps_dprint(sc, MPS_MAPPING, "%s: Found space "
952 				    "in the mapping for enclosure at map index "
953 				    "%d.\n", __func__, start_idx);
954 				return start_idx;
955 			}
956 		} else
957 			num_found = 0;
958 	}
959 
960 	/*
961 	 * If here, it means that not enough space in the mapping table was
962 	 * found to support this enclosure, so go through the enclosure table to
963 	 * see if any enclosure entries have a missing count. If so, get the
964 	 * enclosure with the highest missing count and check it to see if there
965 	 * is enough space for the new enclosure.
966 	 */
967 	while (!done_flag) {
968 		enc_idx = _mapping_get_high_missing_et_idx(sc);
969 		if (enc_idx == MPS_ENCTABLE_BAD_IDX) {
970 			mps_dprint(sc, MPS_MAPPING, "%s: Not enough space was "
971 			    "found in the mapping for the added enclosure.\n",
972 			    __func__);
973 			return MPS_MAPTABLE_BAD_IDX;
974 		}
975 
976 		/*
977 		 * Found a missing enclosure. Set the skip_search flag so this
978 		 * enclosure is not checked again for a high missing count if
979 		 * the loop continues. This way, all missing enclosures can
980 		 * have their space added together to find enough space in the
981 		 * mapping table for the added enclosure. The space must be
982 		 * contiguous.
983 		 */
984 		mps_dprint(sc, MPS_MAPPING, "%s: Space from a missing "
985 		    "enclosure was found.\n", __func__);
986 		enc_entry = &sc->enclosure_table[enc_idx];
987 		enc_entry->skip_search = 1;
988 
989 		/*
990 		 * Unmark all of the missing enclosure's device's reserved
991 		 * space. These will be remarked as reserved if this missing
992 		 * enclosure's space is not used.
993 		 */
994 		mps_dprint(sc, MPS_MAPPING, "%s: Clear the reserved flag for "
995 		    "all of the map entries for the enclosure.\n", __func__);
996 		mt_entry = &sc->mapping_table[enc_entry->start_index];
997 		for (map_idx = enc_entry->start_index; map_idx <
998 		    (enc_entry->start_index + enc_entry->num_slots); map_idx++,
999 		    mt_entry++)
1000 			mt_entry->device_info &= ~MPS_DEV_RESERVED;
1001 
1002 		/*
1003 		 * Now that space has been unreserved, check again to see if
1004 		 * enough space is available for the new enclosure.
1005 		 */
1006 		mps_dprint(sc, MPS_MAPPING, "%s: Check if new mapping space is "
1007 		    "enough for the new enclosure.\n", __func__);
1008 		found_space = 0;
1009 		num_found = 0;
1010 		for (map_idx = (max_num_phy_ids + skip_count);
1011 		    map_idx < end_of_table; map_idx++) {
1012 			mt_entry = &sc->mapping_table[map_idx];
1013 			if (!(mt_entry->device_info & MPS_DEV_RESERVED)) {
1014 				num_found += 1;
1015 				if (num_found == et_entry->num_slots) {
1016 					start_idx = (map_idx - num_found) + 1;
1017 					found_space = 1;
1018 					break;
1019 				}
1020 			} else
1021 				num_found = 0;
1022 		}
1023 		if (!found_space)
1024 			continue;
1025 
1026 		/*
1027 		 * If enough space was found, all of the missing enclosures that
1028 		 * will be used for the new enclosure must be added to the
1029 		 * removal table. Then all mappings for the enclosure's devices
1030 		 * and for the enclosure itself need to be cleared. There may be
1031 		 * more than one enclosure to add to the removal table and
1032 		 * clear.
1033 		 */
1034 		mps_dprint(sc, MPS_MAPPING, "%s: Found space in the mapping "
1035 		    "for enclosure at map index %d.\n", __func__, start_idx);
1036 		for (map_idx = start_idx; map_idx < (start_idx + num_found);
1037 		    map_idx++) {
1038 			enc_entry = sc->enclosure_table;
1039 			for (enc_idx = 0; enc_idx < sc->num_enc_table_entries;
1040 			    enc_idx++, enc_entry++) {
1041 				if (map_idx < enc_entry->start_index ||
1042 				    map_idx > (enc_entry->start_index +
1043 				    enc_entry->num_slots))
1044 					continue;
1045 				if (!enc_entry->removal_flag) {
1046 					mps_dprint(sc, MPS_MAPPING, "%s: "
1047 					    "Enclosure %d will be removed from "
1048 					    "the mapping table.\n", __func__,
1049 					    enc_idx);
1050 					enc_entry->removal_flag = 1;
1051 					_mapping_add_to_removal_table(sc,
1052 					    enc_entry->dpm_entry_num);
1053 				}
1054 				mt_entry = &sc->mapping_table[map_idx];
1055 				_mapping_clear_map_entry(mt_entry);
1056 				if (map_idx == (enc_entry->start_index +
1057 				    enc_entry->num_slots - 1))
1058 					_mapping_clear_enc_entry(et_entry);
1059 			}
1060 		}
1061 
1062 		/*
1063 		 * During the search for space for this enclosure, some entries
1064 		 * in the mapping table may have been unreserved. Go back and
1065 		 * change all of these to reserved again. Only the enclosures
1066 		 * with the removal_flag set should be left as unreserved. The
1067 		 * skip_search flag needs to be cleared as well so that the
1068 		 * enclosure's space will be looked at the next time space is
1069 		 * needed.
1070 		 */
1071 		enc_entry = sc->enclosure_table;
1072 		for (enc_idx = 0; enc_idx < sc->num_enc_table_entries;
1073 		    enc_idx++, enc_entry++) {
1074 			if (!enc_entry->removal_flag) {
1075 				mps_dprint(sc, MPS_MAPPING, "%s: Reset the "
1076 				    "reserved flag for all of the map entries "
1077 				    "for enclosure %d.\n", __func__, enc_idx);
1078 				mt_entry = &sc->mapping_table[enc_entry->
1079 				    start_index];
1080 				for (map_idx = enc_entry->start_index; map_idx <
1081 				    (enc_entry->start_index +
1082 				    enc_entry->num_slots); map_idx++,
1083 				    mt_entry++)
1084 					mt_entry->device_info |=
1085 					    MPS_DEV_RESERVED;
1086 				et_entry->skip_search = 0;
1087 			}
1088 		}
1089 		done_flag = 1;
1090 	}
1091 	return start_idx;
1092 }
1093 
1094 /**
1095  * _mapping_get_dev_info -get information about newly added devices
1096  * @sc: per adapter object
1097  * @topo_change: Topology change event entry
1098  *
1099  * Search through the topology change event list and issues sas device pg0
1100  * requests for the newly added device and reserved entries in tables
1101  *
1102  * Returns nothing
1103  */
1104 static void
1105 _mapping_get_dev_info(struct mps_softc *sc,
1106     struct _map_topology_change *topo_change)
1107 {
1108 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
1109 	Mpi2ConfigReply_t mpi_reply;
1110 	Mpi2SasDevicePage0_t sas_device_pg0;
1111 	u8 entry, enc_idx, phy_idx;
1112 	u32 map_idx, index, device_info;
1113 	struct _map_phy_change *phy_change, *tmp_phy_change;
1114 	uint64_t sas_address;
1115 	struct enc_mapping_table *et_entry;
1116 	struct dev_mapping_table *mt_entry;
1117 	u8 add_code = MPI2_EVENT_SAS_TOPO_RC_TARG_ADDED;
1118 	int rc = 1;
1119 
1120 	for (entry = 0; entry < topo_change->num_entries; entry++) {
1121 		phy_change = &topo_change->phy_details[entry];
1122 		if (phy_change->is_processed || !phy_change->dev_handle ||
1123 		    phy_change->reason != MPI2_EVENT_SAS_TOPO_RC_TARG_ADDED)
1124 			continue;
1125 
1126 		if (mps_config_get_sas_device_pg0(sc, &mpi_reply,
1127 		    &sas_device_pg0, MPI2_SAS_DEVICE_PGAD_FORM_HANDLE,
1128 		    phy_change->dev_handle)) {
1129 			phy_change->is_processed = 1;
1130 			continue;
1131 		}
1132 
1133 		/*
1134 		 * Always get SATA Identify information because this is used
1135 		 * to determine if Start/Stop Unit should be sent to the drive
1136 		 * when the system is shutdown.
1137 		 */
1138 		device_info = le32toh(sas_device_pg0.DeviceInfo);
1139 		sas_address = le32toh(sas_device_pg0.SASAddress.High);
1140 		sas_address = (sas_address << 32) |
1141 		    le32toh(sas_device_pg0.SASAddress.Low);
1142 		if ((device_info & MPI2_SAS_DEVICE_INFO_END_DEVICE) &&
1143 		    (device_info & MPI2_SAS_DEVICE_INFO_SATA_DEVICE)) {
1144 			rc = mpssas_get_sas_address_for_sata_disk(sc,
1145 			    &sas_address, phy_change->dev_handle, device_info,
1146 			    &phy_change->is_SATA_SSD);
1147 			if (rc) {
1148 				mps_dprint(sc, MPS_ERROR, "%s: failed to get "
1149 				    "disk type (SSD or HDD) and SAS Address "
1150 				    "for SATA device with handle 0x%04x\n",
1151 				    __func__, phy_change->dev_handle);
1152 			}
1153 		}
1154 
1155 		phy_change->physical_id = sas_address;
1156 		phy_change->slot = le16toh(sas_device_pg0.Slot);
1157 		phy_change->device_info = device_info;
1158 
1159 		/*
1160 		 * When using Enc/Slot mapping, if this device is an enclosure
1161 		 * make sure that all of its slots can fit into the mapping
1162 		 * table.
1163 		 */
1164 		if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
1165 		    MPI2_IOCPAGE8_FLAGS_ENCLOSURE_SLOT_MAPPING) {
1166 			/*
1167 			 * The enclosure should already be in the enclosure
1168 			 * table due to the Enclosure Add event. If not, just
1169 			 * continue, nothing can be done.
1170 			 */
1171 			enc_idx = _mapping_get_enc_idx_from_handle(sc,
1172 			    topo_change->enc_handle);
1173 			if (enc_idx == MPS_ENCTABLE_BAD_IDX) {
1174 				phy_change->is_processed = 1;
1175 				mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: "
1176 				    "failed to add the device with handle "
1177 				    "0x%04x because the enclosure is not in "
1178 				    "the mapping table\n", __func__,
1179 				    phy_change->dev_handle);
1180 				continue;
1181 			}
1182 			if (!((phy_change->device_info &
1183 			    MPI2_SAS_DEVICE_INFO_END_DEVICE) &&
1184 			    (phy_change->device_info &
1185 			    (MPI2_SAS_DEVICE_INFO_SSP_TARGET |
1186 			    MPI2_SAS_DEVICE_INFO_STP_TARGET |
1187 			    MPI2_SAS_DEVICE_INFO_SATA_DEVICE)))) {
1188 				phy_change->is_processed = 1;
1189 				continue;
1190 			}
1191 			et_entry = &sc->enclosure_table[enc_idx];
1192 
1193 			/*
1194 			 * If the enclosure already has a start_index, it's been
1195 			 * mapped, so go to the next Topo change.
1196 			 */
1197 			if (et_entry->start_index != MPS_MAPTABLE_BAD_IDX)
1198 				continue;
1199 
1200 			/*
1201 			 * If the Expander Handle is 0, the devices are direct
1202 			 * attached. In that case, the start_index must be just
1203 			 * after the reserved entries. Otherwise, find space in
1204 			 * the mapping table for the enclosure's devices.
1205 			 */
1206 			if (!topo_change->exp_handle) {
1207 				map_idx	= sc->num_rsvd_entries;
1208 				et_entry->start_index = map_idx;
1209 			} else {
1210 				map_idx = _mapping_find_enc_map_space(sc,
1211 				    et_entry);
1212 				et_entry->start_index = map_idx;
1213 
1214 				/*
1215 				 * If space cannot be found to hold all of the
1216 				 * enclosure's devices in the mapping table,
1217 				 * there's no need to continue checking the
1218 				 * other devices in this event. Set all of the
1219 				 * phy_details for this event (if the change is
1220 				 * for an add) as already processed because none
1221 				 * of these devices can be added to the mapping
1222 				 * table.
1223 				 */
1224 				if (et_entry->start_index ==
1225 				    MPS_MAPTABLE_BAD_IDX) {
1226 					mps_dprint(sc, MPS_ERROR | MPS_MAPPING,
1227 					    "%s: failed to add the enclosure "
1228 					    "with ID 0x%016jx because there is "
1229 					    "no free space available in the "
1230 					    "mapping table for all of the "
1231 					    "enclosure's devices.\n", __func__,
1232 					    (uintmax_t)et_entry->enclosure_id);
1233 					phy_change->is_processed = 1;
1234 					for (phy_idx = 0; phy_idx <
1235 					    topo_change->num_entries;
1236 					    phy_idx++) {
1237 						tmp_phy_change =
1238 						    &topo_change->phy_details
1239 						    [phy_idx];
1240 						if (tmp_phy_change->reason ==
1241 						    add_code)
1242 							tmp_phy_change->
1243 							    is_processed = 1;
1244 					}
1245 					break;
1246 				}
1247 			}
1248 
1249 			/*
1250 			 * Found space in the mapping table for this enclosure.
1251 			 * Initialize each mapping table entry for the
1252 			 * enclosure.
1253 			 */
1254 			mps_dprint(sc, MPS_MAPPING, "%s: Initialize %d map "
1255 			    "entries for the enclosure, starting at map index "
1256 			    " %d.\n", __func__, et_entry->num_slots, map_idx);
1257 			mt_entry = &sc->mapping_table[map_idx];
1258 			for (index = map_idx; index < (et_entry->num_slots
1259 			    + map_idx); index++, mt_entry++) {
1260 				mt_entry->device_info = MPS_DEV_RESERVED;
1261 				mt_entry->physical_id = et_entry->enclosure_id;
1262 				mt_entry->phy_bits = et_entry->phy_bits;
1263 				mt_entry->missing_count = 0;
1264 			}
1265 		}
1266 	}
1267 }
1268 
1269 /**
1270  * _mapping_set_mid_to_eid -set map table data from enclosure table
1271  * @sc: per adapter object
1272  * @et_entry: enclosure entry
1273  *
1274  * Returns nothing
1275  */
1276 static inline void
1277 _mapping_set_mid_to_eid(struct mps_softc *sc,
1278     struct enc_mapping_table *et_entry)
1279 {
1280 	struct dev_mapping_table *mt_entry;
1281 	u16 slots = et_entry->num_slots, map_idx;
1282 	u32 start_idx = et_entry->start_index;
1283 
1284 	if (start_idx != MPS_MAPTABLE_BAD_IDX) {
1285 		mt_entry = &sc->mapping_table[start_idx];
1286 		for (map_idx = 0; map_idx < slots; map_idx++, mt_entry++)
1287 			mt_entry->physical_id = et_entry->enclosure_id;
1288 	}
1289 }
1290 
1291 /**
1292  * _mapping_clear_removed_entries - mark the entries to be cleared
1293  * @sc: per adapter object
1294  *
1295  * Search through the removal table and mark the entries which needs to be
1296  * flushed to DPM and also updates the map table and enclosure table by
1297  * clearing the corresponding entries.
1298  *
1299  * Returns nothing
1300  */
1301 static void
1302 _mapping_clear_removed_entries(struct mps_softc *sc)
1303 {
1304 	u32 remove_idx;
1305 	struct map_removal_table *remove_entry;
1306 	Mpi2DriverMap0Entry_t *dpm_entry;
1307 	u8 done_flag = 0, num_entries, m, i;
1308 	struct enc_mapping_table *et_entry, *from, *to;
1309 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
1310 
1311 	if (sc->is_dpm_enable) {
1312 		remove_entry = sc->removal_table;
1313 		for (remove_idx = 0; remove_idx < sc->max_devices;
1314 		    remove_idx++, remove_entry++) {
1315 			if (remove_entry->dpm_entry_num != MPS_DPM_BAD_IDX) {
1316 				dpm_entry = (Mpi2DriverMap0Entry_t *)
1317 				    ((u8 *) sc->dpm_pg0 +
1318 				    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
1319 				dpm_entry += remove_entry->dpm_entry_num;
1320 				dpm_entry->PhysicalIdentifier.Low = 0;
1321 				dpm_entry->PhysicalIdentifier.High = 0;
1322 				dpm_entry->DeviceIndex = 0;
1323 				dpm_entry->MappingInformation = 0;
1324 				dpm_entry->PhysicalBitsMapping = 0;
1325 				sc->dpm_flush_entry[remove_entry->
1326 				    dpm_entry_num] = 1;
1327 				sc->dpm_entry_used[remove_entry->dpm_entry_num]
1328 				    = 0;
1329 				remove_entry->dpm_entry_num = MPS_DPM_BAD_IDX;
1330 			}
1331 		}
1332 	}
1333 
1334 	/*
1335 	 * When using Enc/Slot mapping, if a new enclosure was added and old
1336 	 * enclosure space was needed, the enclosure table may now have gaps
1337 	 * that need to be closed. All enclosure mappings need to be contiguous
1338 	 * so that space can be reused correctly if available.
1339 	 */
1340 	if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
1341 	    MPI2_IOCPAGE8_FLAGS_ENCLOSURE_SLOT_MAPPING) {
1342 		num_entries = sc->num_enc_table_entries;
1343 		while (!done_flag) {
1344 			done_flag = 1;
1345 			et_entry = sc->enclosure_table;
1346 			for (i = 0; i < num_entries; i++, et_entry++) {
1347 				if (!et_entry->enc_handle && et_entry->
1348 				    init_complete) {
1349 					done_flag = 0;
1350 					if (i != (num_entries - 1)) {
1351 						from = &sc->enclosure_table
1352 						    [i+1];
1353 						to = &sc->enclosure_table[i];
1354 						for (m = i; m < (num_entries -
1355 						    1); m++, from++, to++) {
1356 							_mapping_set_mid_to_eid
1357 							    (sc, to);
1358 							*to = *from;
1359 						}
1360 						_mapping_clear_enc_entry(to);
1361 						sc->num_enc_table_entries--;
1362 						num_entries =
1363 						    sc->num_enc_table_entries;
1364 					} else {
1365 						_mapping_clear_enc_entry
1366 						    (et_entry);
1367 						sc->num_enc_table_entries--;
1368 						num_entries =
1369 						    sc->num_enc_table_entries;
1370 					}
1371 				}
1372 			}
1373 		}
1374 	}
1375 }
1376 
1377 /**
1378  * _mapping_add_new_device -Add the new device into mapping table
1379  * @sc: per adapter object
1380  * @topo_change: Topology change event entry
1381  *
1382  * Search through the topology change event list and update map table,
1383  * enclosure table and DPM pages for the newly added devices.
1384  *
1385  * Returns nothing
1386  */
1387 static void
1388 _mapping_add_new_device(struct mps_softc *sc,
1389     struct _map_topology_change *topo_change)
1390 {
1391 	u8 enc_idx, missing_cnt, is_removed = 0;
1392 	u16 dpm_idx;
1393 	u32 search_idx, map_idx;
1394 	u32 entry;
1395 	struct dev_mapping_table *mt_entry;
1396 	struct enc_mapping_table *et_entry;
1397 	struct _map_phy_change *phy_change;
1398 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
1399 	Mpi2DriverMap0Entry_t *dpm_entry;
1400 	uint64_t temp64_var;
1401 	u8 map_shift = MPI2_DRVMAP0_MAPINFO_SLOT_SHIFT;
1402 	u8 hdr_sz = sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER);
1403 	u16 max_num_phy_ids = le16toh(sc->ioc_pg8.MaxNumPhysicalMappedIDs);
1404 
1405 	for (entry = 0; entry < topo_change->num_entries; entry++) {
1406 		phy_change = &topo_change->phy_details[entry];
1407 		if (phy_change->is_processed)
1408 			continue;
1409 		if (phy_change->reason != MPI2_EVENT_SAS_TOPO_RC_TARG_ADDED ||
1410 		    !phy_change->dev_handle) {
1411 			phy_change->is_processed = 1;
1412 			continue;
1413 		}
1414 		if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
1415 		    MPI2_IOCPAGE8_FLAGS_ENCLOSURE_SLOT_MAPPING) {
1416 			enc_idx = _mapping_get_enc_idx_from_handle
1417 			    (sc, topo_change->enc_handle);
1418 			if (enc_idx == MPS_ENCTABLE_BAD_IDX) {
1419 				phy_change->is_processed = 1;
1420 				mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: "
1421 				    "failed to add the device with handle "
1422 				    "0x%04x because the enclosure is not in "
1423 				    "the mapping table\n", __func__,
1424 				    phy_change->dev_handle);
1425 				continue;
1426 			}
1427 
1428 			/*
1429 			 * If the enclosure's start_index is BAD here, it means
1430 			 * that there is no room in the mapping table to cover
1431 			 * all of the devices that could be in the enclosure.
1432 			 * There's no reason to process any of the devices for
1433 			 * this enclosure since they can't be mapped.
1434 			 */
1435 			et_entry = &sc->enclosure_table[enc_idx];
1436 			if (et_entry->start_index == MPS_MAPTABLE_BAD_IDX) {
1437 				phy_change->is_processed = 1;
1438 				mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: "
1439 				    "failed to add the device with handle "
1440 				    "0x%04x because there is no free space "
1441 				    "available in the mapping table\n",
1442 				    __func__, phy_change->dev_handle);
1443 				continue;
1444 			}
1445 
1446 			/*
1447 			 * Add this device to the mapping table at the correct
1448 			 * offset where space was found to map the enclosure.
1449 			 * Then setup the DPM entry information if being used.
1450 			 */
1451 			map_idx = et_entry->start_index + phy_change->slot -
1452 			    et_entry->start_slot;
1453 			mt_entry = &sc->mapping_table[map_idx];
1454 			mt_entry->physical_id = phy_change->physical_id;
1455 			mt_entry->id = map_idx;
1456 			mt_entry->dev_handle = phy_change->dev_handle;
1457 			mt_entry->missing_count = 0;
1458 			mt_entry->dpm_entry_num = et_entry->dpm_entry_num;
1459 			mt_entry->device_info = phy_change->device_info |
1460 			    (MPS_DEV_RESERVED | MPS_MAP_IN_USE);
1461 			if (sc->is_dpm_enable) {
1462 				dpm_idx = et_entry->dpm_entry_num;
1463 				if (dpm_idx == MPS_DPM_BAD_IDX)
1464 					dpm_idx = _mapping_get_dpm_idx_from_id
1465 					    (sc, et_entry->enclosure_id,
1466 					     et_entry->phy_bits);
1467 				if (dpm_idx == MPS_DPM_BAD_IDX) {
1468 					dpm_idx = _mapping_get_free_dpm_idx(sc);
1469 					if (dpm_idx != MPS_DPM_BAD_IDX) {
1470 						dpm_entry =
1471 						    (Mpi2DriverMap0Entry_t *)
1472 						    ((u8 *) sc->dpm_pg0 +
1473 						     hdr_sz);
1474 						dpm_entry += dpm_idx;
1475 						dpm_entry->
1476 						    PhysicalIdentifier.Low =
1477 						    (0xFFFFFFFF &
1478 						    et_entry->enclosure_id);
1479 						dpm_entry->
1480 						    PhysicalIdentifier.High =
1481 						    (et_entry->enclosure_id
1482 						     >> 32);
1483 						dpm_entry->DeviceIndex =
1484 						    (U16)et_entry->start_index;
1485 						dpm_entry->MappingInformation =
1486 						    et_entry->num_slots;
1487 						dpm_entry->MappingInformation
1488 						    <<= map_shift;
1489 						dpm_entry->PhysicalBitsMapping
1490 						    = et_entry->phy_bits;
1491 						et_entry->dpm_entry_num =
1492 						    dpm_idx;
1493 						sc->dpm_entry_used[dpm_idx] = 1;
1494 						sc->dpm_flush_entry[dpm_idx] =
1495 						    1;
1496 						phy_change->is_processed = 1;
1497 					} else {
1498 						phy_change->is_processed = 1;
1499 						mps_dprint(sc, MPS_ERROR |
1500 						    MPS_MAPPING, "%s: failed "
1501 						    "to add the device with "
1502 						    "handle 0x%04x to "
1503 						    "persistent table because "
1504 						    "there is no free space "
1505 						    "available\n", __func__,
1506 						    phy_change->dev_handle);
1507 					}
1508 				} else {
1509 					et_entry->dpm_entry_num = dpm_idx;
1510 					mt_entry->dpm_entry_num = dpm_idx;
1511 				}
1512 			}
1513 			et_entry->init_complete = 1;
1514 		} else if ((ioc_pg8_flags &
1515 		    MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
1516 		    MPI2_IOCPAGE8_FLAGS_DEVICE_PERSISTENCE_MAPPING) {
1517 
1518 			/*
1519 			 * Get the mapping table index for this device. If it's
1520 			 * not in the mapping table yet, find a free entry if
1521 			 * one is available. If there are no free entries, look
1522 			 * for the entry that has the highest missing count. If
1523 			 * none of that works to find an entry in the mapping
1524 			 * table, there is a problem. Log a message and just
1525 			 * continue on.
1526 			 */
1527 			map_idx = _mapping_get_mt_idx_from_id
1528 			    (sc, phy_change->physical_id);
1529 			if (map_idx == MPS_MAPTABLE_BAD_IDX) {
1530 				search_idx = sc->num_rsvd_entries;
1531 				if (topo_change->exp_handle)
1532 					search_idx += max_num_phy_ids;
1533 				map_idx = _mapping_get_free_mt_idx(sc,
1534 				    search_idx);
1535 			}
1536 
1537 			/*
1538 			 * If an entry will be used that has a missing device,
1539 			 * clear its entry from  the DPM in the controller.
1540 			 */
1541 			if (map_idx == MPS_MAPTABLE_BAD_IDX) {
1542 				map_idx = _mapping_get_high_missing_mt_idx(sc);
1543 				if (map_idx != MPS_MAPTABLE_BAD_IDX) {
1544 					mt_entry = &sc->mapping_table[map_idx];
1545 					_mapping_add_to_removal_table(sc,
1546 					    mt_entry->dpm_entry_num);
1547 					is_removed = 1;
1548 					mt_entry->init_complete = 0;
1549 				}
1550 			}
1551 			if (map_idx != MPS_MAPTABLE_BAD_IDX) {
1552 				mt_entry = &sc->mapping_table[map_idx];
1553 				mt_entry->physical_id = phy_change->physical_id;
1554 				mt_entry->id = map_idx;
1555 				mt_entry->dev_handle = phy_change->dev_handle;
1556 				mt_entry->missing_count = 0;
1557 				mt_entry->device_info = phy_change->device_info
1558 				    | (MPS_DEV_RESERVED | MPS_MAP_IN_USE);
1559 			} else {
1560 				phy_change->is_processed = 1;
1561 				mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: "
1562 				    "failed to add the device with handle "
1563 				    "0x%04x because there is no free space "
1564 				    "available in the mapping table\n",
1565 				    __func__, phy_change->dev_handle);
1566 				continue;
1567 			}
1568 			if (sc->is_dpm_enable) {
1569 				if (mt_entry->dpm_entry_num !=
1570 				    MPS_DPM_BAD_IDX) {
1571 					dpm_idx = mt_entry->dpm_entry_num;
1572 					dpm_entry = (Mpi2DriverMap0Entry_t *)
1573 					    ((u8 *)sc->dpm_pg0 + hdr_sz);
1574 					dpm_entry += dpm_idx;
1575 					missing_cnt = dpm_entry->
1576 					    MappingInformation &
1577 					    MPI2_DRVMAP0_MAPINFO_MISSING_MASK;
1578 					temp64_var = dpm_entry->
1579 					    PhysicalIdentifier.High;
1580 					temp64_var = (temp64_var << 32) |
1581 					   dpm_entry->PhysicalIdentifier.Low;
1582 
1583 					/*
1584 					 * If the Mapping Table's info is not
1585 					 * the same as the DPM entry, clear the
1586 					 * init_complete flag so that it's
1587 					 * updated.
1588 					 */
1589 					if ((mt_entry->physical_id ==
1590 					    temp64_var) && !missing_cnt)
1591 						mt_entry->init_complete = 1;
1592 					else
1593 						mt_entry->init_complete = 0;
1594 				} else {
1595 					dpm_idx = _mapping_get_free_dpm_idx(sc);
1596 					mt_entry->init_complete = 0;
1597 				}
1598 				if (dpm_idx != MPS_DPM_BAD_IDX &&
1599 				    !mt_entry->init_complete) {
1600 					mt_entry->dpm_entry_num = dpm_idx;
1601 					dpm_entry = (Mpi2DriverMap0Entry_t *)
1602 					    ((u8 *)sc->dpm_pg0 + hdr_sz);
1603 					dpm_entry += dpm_idx;
1604 					dpm_entry->PhysicalIdentifier.Low =
1605 					    (0xFFFFFFFF &
1606 					    mt_entry->physical_id);
1607 					dpm_entry->PhysicalIdentifier.High =
1608 					    (mt_entry->physical_id >> 32);
1609 					dpm_entry->DeviceIndex = (U16) map_idx;
1610 					dpm_entry->MappingInformation = 0;
1611 					dpm_entry->PhysicalBitsMapping = 0;
1612 					sc->dpm_entry_used[dpm_idx] = 1;
1613 					sc->dpm_flush_entry[dpm_idx] = 1;
1614 					phy_change->is_processed = 1;
1615 				} else if (dpm_idx == MPS_DPM_BAD_IDX) {
1616 					phy_change->is_processed = 1;
1617 					mps_dprint(sc, MPS_ERROR | MPS_MAPPING,
1618 					    "%s: failed to add the device with "
1619 					    "handle 0x%04x to persistent table "
1620 					    "because there is no free space "
1621 					    "available\n", __func__,
1622 					    phy_change->dev_handle);
1623 				}
1624 			}
1625 			mt_entry->init_complete = 1;
1626 		}
1627 
1628 		phy_change->is_processed = 1;
1629 	}
1630 	if (is_removed)
1631 		_mapping_clear_removed_entries(sc);
1632 }
1633 
1634 /**
1635  * _mapping_flush_dpm_pages -Flush the DPM pages to NVRAM
1636  * @sc: per adapter object
1637  *
1638  * Returns nothing
1639  */
1640 static void
1641 _mapping_flush_dpm_pages(struct mps_softc *sc)
1642 {
1643 	Mpi2DriverMap0Entry_t *dpm_entry;
1644 	Mpi2ConfigReply_t mpi_reply;
1645 	Mpi2DriverMappingPage0_t config_page;
1646 	u16 entry_num;
1647 
1648 	for (entry_num = 0; entry_num < sc->max_dpm_entries; entry_num++) {
1649 		if (!sc->dpm_flush_entry[entry_num])
1650 			continue;
1651 		memset(&config_page, 0, sizeof(Mpi2DriverMappingPage0_t));
1652 		memcpy(&config_page.Header, (u8 *)sc->dpm_pg0,
1653 		    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
1654 		dpm_entry = (Mpi2DriverMap0Entry_t *) ((u8 *)sc->dpm_pg0 +
1655 		    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
1656 		dpm_entry += entry_num;
1657 		dpm_entry->MappingInformation = htole16(dpm_entry->
1658 		    MappingInformation);
1659 		dpm_entry->DeviceIndex = htole16(dpm_entry->DeviceIndex);
1660 		dpm_entry->PhysicalBitsMapping = htole32(dpm_entry->
1661 		    PhysicalBitsMapping);
1662 		memcpy(&config_page.Entry, (u8 *)dpm_entry,
1663 		    sizeof(Mpi2DriverMap0Entry_t));
1664 		/* TODO-How to handle failed writes? */
1665 		mps_dprint(sc, MPS_MAPPING, "%s: Flushing DPM entry %d.\n",
1666 		    __func__, entry_num);
1667 		if (mps_config_set_dpm_pg0(sc, &mpi_reply, &config_page,
1668 		    entry_num)) {
1669 			mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: Flush of "
1670 			    "DPM entry %d for device failed\n", __func__,
1671 			    entry_num);
1672 		} else
1673 			sc->dpm_flush_entry[entry_num] = 0;
1674 		dpm_entry->MappingInformation = le16toh(dpm_entry->
1675 		    MappingInformation);
1676 		dpm_entry->DeviceIndex = le16toh(dpm_entry->DeviceIndex);
1677 		dpm_entry->PhysicalBitsMapping = le32toh(dpm_entry->
1678 		    PhysicalBitsMapping);
1679 	}
1680 }
1681 
1682 /**
1683  * _mapping_allocate_memory- allocates the memory required for mapping tables
1684  * @sc: per adapter object
1685  *
1686  * Allocates the memory for all the tables required for host mapping
1687  *
1688  * Return 0 on success or non-zero on failure.
1689  */
1690 int
1691 mps_mapping_allocate_memory(struct mps_softc *sc)
1692 {
1693 	uint32_t dpm_pg0_sz;
1694 
1695 	sc->mapping_table = malloc((sizeof(struct dev_mapping_table) *
1696 	    sc->max_devices), M_MPT2, M_ZERO|M_NOWAIT);
1697 	if (!sc->mapping_table)
1698 		goto free_resources;
1699 
1700 	sc->removal_table = malloc((sizeof(struct map_removal_table) *
1701 	    sc->max_devices), M_MPT2, M_ZERO|M_NOWAIT);
1702 	if (!sc->removal_table)
1703 		goto free_resources;
1704 
1705 	sc->enclosure_table = malloc((sizeof(struct enc_mapping_table) *
1706 	    sc->max_enclosures), M_MPT2, M_ZERO|M_NOWAIT);
1707 	if (!sc->enclosure_table)
1708 		goto free_resources;
1709 
1710 	sc->dpm_entry_used = malloc((sizeof(u8) * sc->max_dpm_entries),
1711 	    M_MPT2, M_ZERO|M_NOWAIT);
1712 	if (!sc->dpm_entry_used)
1713 		goto free_resources;
1714 
1715 	sc->dpm_flush_entry = malloc((sizeof(u8) * sc->max_dpm_entries),
1716 	    M_MPT2, M_ZERO|M_NOWAIT);
1717 	if (!sc->dpm_flush_entry)
1718 		goto free_resources;
1719 
1720 	dpm_pg0_sz = sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER) +
1721 	    (sc->max_dpm_entries * sizeof(MPI2_CONFIG_PAGE_DRIVER_MAP0_ENTRY));
1722 
1723 	sc->dpm_pg0 = malloc(dpm_pg0_sz, M_MPT2, M_ZERO|M_NOWAIT);
1724 	if (!sc->dpm_pg0) {
1725 		printf("%s: memory alloc failed for dpm page; disabling dpm\n",
1726 		    __func__);
1727 		sc->is_dpm_enable = 0;
1728 	}
1729 
1730 	return 0;
1731 
1732 free_resources:
1733 	free(sc->mapping_table, M_MPT2);
1734 	free(sc->removal_table, M_MPT2);
1735 	free(sc->enclosure_table, M_MPT2);
1736 	free(sc->dpm_entry_used, M_MPT2);
1737 	free(sc->dpm_flush_entry, M_MPT2);
1738 	free(sc->dpm_pg0, M_MPT2);
1739 	printf("%s: device initialization failed due to failure in mapping "
1740 	    "table memory allocation\n", __func__);
1741 	return -1;
1742 }
1743 
1744 /**
1745  * mps_mapping_free_memory- frees the memory allocated for mapping tables
1746  * @sc: per adapter object
1747  *
1748  * Returns nothing.
1749  */
1750 void
1751 mps_mapping_free_memory(struct mps_softc *sc)
1752 {
1753 	free(sc->mapping_table, M_MPT2);
1754 	free(sc->removal_table, M_MPT2);
1755 	free(sc->enclosure_table, M_MPT2);
1756 	free(sc->dpm_entry_used, M_MPT2);
1757 	free(sc->dpm_flush_entry, M_MPT2);
1758 	free(sc->dpm_pg0, M_MPT2);
1759 }
1760 
1761 static void
1762 _mapping_process_dpm_pg0(struct mps_softc *sc)
1763 {
1764 	u8 missing_cnt, enc_idx;
1765 	u16 slot_id, entry_num, num_slots;
1766 	u32 map_idx, dev_idx, start_idx, end_idx;
1767 	struct dev_mapping_table *mt_entry;
1768 	Mpi2DriverMap0Entry_t *dpm_entry;
1769 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
1770 	u16 max_num_phy_ids = le16toh(sc->ioc_pg8.MaxNumPhysicalMappedIDs);
1771 	struct enc_mapping_table *et_entry;
1772 	u64 physical_id;
1773 	u32 phy_bits = 0;
1774 
1775 	/*
1776 	 * start_idx and end_idx are only used for IR.
1777 	 */
1778 	if (sc->ir_firmware)
1779 		_mapping_get_ir_maprange(sc, &start_idx, &end_idx);
1780 
1781 	/*
1782 	 * Look through all of the DPM entries that were read from the
1783 	 * controller and copy them over to the driver's internal table if they
1784 	 * have a non-zero ID. At this point, any ID with a value of 0 would be
1785 	 * invalid, so don't copy it.
1786 	 */
1787 	mps_dprint(sc, MPS_MAPPING, "%s: Start copy of %d DPM entries into the "
1788 	    "mapping table.\n", __func__, sc->max_dpm_entries);
1789 	dpm_entry = (Mpi2DriverMap0Entry_t *) ((uint8_t *) sc->dpm_pg0 +
1790 	    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
1791 	for (entry_num = 0; entry_num < sc->max_dpm_entries; entry_num++,
1792 	    dpm_entry++) {
1793 		physical_id = dpm_entry->PhysicalIdentifier.High;
1794 		physical_id = (physical_id << 32) |
1795 		    dpm_entry->PhysicalIdentifier.Low;
1796 		if (!physical_id) {
1797 			sc->dpm_entry_used[entry_num] = 0;
1798 			continue;
1799 		}
1800 		sc->dpm_entry_used[entry_num] = 1;
1801 		dpm_entry->MappingInformation = le16toh(dpm_entry->
1802 		    MappingInformation);
1803 		missing_cnt = dpm_entry->MappingInformation &
1804 		    MPI2_DRVMAP0_MAPINFO_MISSING_MASK;
1805 		dev_idx = le16toh(dpm_entry->DeviceIndex);
1806 		phy_bits = le32toh(dpm_entry->PhysicalBitsMapping);
1807 
1808 		/*
1809 		 * Volumes are at special locations in the mapping table so
1810 		 * account for that. Volume mapping table entries do not depend
1811 		 * on the type of mapping, so continue the loop after adding
1812 		 * volumes to the mapping table.
1813 		 */
1814 		if (sc->ir_firmware && (dev_idx >= start_idx) &&
1815 		    (dev_idx <= end_idx)) {
1816 			mt_entry = &sc->mapping_table[dev_idx];
1817 			mt_entry->physical_id =
1818 			    dpm_entry->PhysicalIdentifier.High;
1819 			mt_entry->physical_id = (mt_entry->physical_id << 32) |
1820 			    dpm_entry->PhysicalIdentifier.Low;
1821 			mt_entry->id = dev_idx;
1822 			mt_entry->missing_count = missing_cnt;
1823 			mt_entry->dpm_entry_num = entry_num;
1824 			mt_entry->device_info = MPS_DEV_RESERVED;
1825 			continue;
1826 		}
1827 		if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
1828 		    MPI2_IOCPAGE8_FLAGS_ENCLOSURE_SLOT_MAPPING) {
1829 
1830 			/*
1831 			 * The dev_idx for an enclosure is the start index. If
1832 			 * the start index is within the controller's default
1833 			 * enclosure area, set the number of slots for this
1834 			 * enclosure to the max allowed. Otherwise, it should be
1835 			 * a normal enclosure and the number of slots is in the
1836 			 * DPM entry's Mapping Information.
1837 			 */
1838 			if (dev_idx < (sc->num_rsvd_entries +
1839 			    max_num_phy_ids)) {
1840 				slot_id = 0;
1841 				if (ioc_pg8_flags &
1842 				    MPI2_IOCPAGE8_FLAGS_DA_START_SLOT_1)
1843 					slot_id = 1;
1844 				num_slots = max_num_phy_ids;
1845 			} else {
1846 				slot_id = 0;
1847 				num_slots = dpm_entry->MappingInformation &
1848 				    MPI2_DRVMAP0_MAPINFO_SLOT_MASK;
1849 				num_slots >>= MPI2_DRVMAP0_MAPINFO_SLOT_SHIFT;
1850 			}
1851 			enc_idx = sc->num_enc_table_entries;
1852 			if (enc_idx >= sc->max_enclosures) {
1853 				mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: "
1854 				    "Number of enclosure entries in DPM exceed "
1855 				    "the max allowed of %d.\n", __func__,
1856 				    sc->max_enclosures);
1857 				break;
1858 			}
1859 			sc->num_enc_table_entries++;
1860 			et_entry = &sc->enclosure_table[enc_idx];
1861 			physical_id = dpm_entry->PhysicalIdentifier.High;
1862 			et_entry->enclosure_id = (physical_id << 32) |
1863 			    dpm_entry->PhysicalIdentifier.Low;
1864 			et_entry->start_index = dev_idx;
1865 			et_entry->dpm_entry_num = entry_num;
1866 			et_entry->num_slots = num_slots;
1867 			et_entry->start_slot = slot_id;
1868 			et_entry->missing_count = missing_cnt;
1869 			et_entry->phy_bits = phy_bits;
1870 
1871 			/*
1872 			 * Initialize all entries for this enclosure in the
1873 			 * mapping table and mark them as reserved. The actual
1874 			 * devices have not been processed yet but when they are
1875 			 * they will use these entries. If an entry is found
1876 			 * that already has a valid DPM index, the mapping table
1877 			 * is corrupt. This can happen if the mapping type is
1878 			 * changed without clearing all of the DPM entries in
1879 			 * the controller.
1880 			 */
1881 			mt_entry = &sc->mapping_table[dev_idx];
1882 			for (map_idx = dev_idx; map_idx < (dev_idx + num_slots);
1883 			    map_idx++, mt_entry++) {
1884 				if (mt_entry->dpm_entry_num !=
1885 				    MPS_DPM_BAD_IDX) {
1886 					mps_dprint(sc, MPS_ERROR | MPS_MAPPING,
1887 					    "%s: Conflict in mapping table for "
1888 					    " enclosure %d\n", __func__,
1889 					    enc_idx);
1890 					break;
1891 				}
1892 				physical_id =
1893 				    dpm_entry->PhysicalIdentifier.High;
1894 				mt_entry->physical_id = (physical_id << 32) |
1895 				    dpm_entry->PhysicalIdentifier.Low;
1896 				mt_entry->phy_bits = phy_bits;
1897 				mt_entry->id = dev_idx;
1898 				mt_entry->dpm_entry_num = entry_num;
1899 				mt_entry->missing_count = missing_cnt;
1900 				mt_entry->device_info = MPS_DEV_RESERVED;
1901 			}
1902 		} else if ((ioc_pg8_flags &
1903 		    MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
1904 		    MPI2_IOCPAGE8_FLAGS_DEVICE_PERSISTENCE_MAPPING) {
1905 
1906 			/*
1907 			 * Device mapping, so simply copy the DPM entries to the
1908 			 * mapping table, but check for a corrupt mapping table
1909 			 * (as described above in Enc/Slot mapping).
1910 			 */
1911 			map_idx = dev_idx;
1912 			mt_entry = &sc->mapping_table[map_idx];
1913 			if (mt_entry->dpm_entry_num != MPS_DPM_BAD_IDX) {
1914 				mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: "
1915 				    "Conflict in mapping table for device %d\n",
1916 				    __func__, map_idx);
1917 				break;
1918 			}
1919 			physical_id = dpm_entry->PhysicalIdentifier.High;
1920 			mt_entry->physical_id = (physical_id << 32) |
1921 			    dpm_entry->PhysicalIdentifier.Low;
1922 			mt_entry->phy_bits = phy_bits;
1923 			mt_entry->id = dev_idx;
1924 			mt_entry->missing_count = missing_cnt;
1925 			mt_entry->dpm_entry_num = entry_num;
1926 			mt_entry->device_info = MPS_DEV_RESERVED;
1927 		}
1928 	} /*close the loop for DPM table */
1929 }
1930 
1931 /*
1932  * mps_mapping_check_devices - start of the day check for device availabilty
1933  * @sc: per adapter object
1934  *
1935  * Returns nothing.
1936  */
1937 void
1938 mps_mapping_check_devices(void *data)
1939 {
1940 	u32 i;
1941 	struct dev_mapping_table *mt_entry;
1942 	struct mps_softc *sc = (struct mps_softc *)data;
1943 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
1944 	struct enc_mapping_table *et_entry;
1945 	u32 start_idx = 0, end_idx = 0;
1946 	u8 stop_device_checks = 0;
1947 
1948 	MPS_FUNCTRACE(sc);
1949 
1950 	/*
1951 	 * Clear this flag so that this function is never called again except
1952 	 * within this function if the check needs to be done again. The
1953 	 * purpose is to check for missing devices that are currently in the
1954 	 * mapping table so do this only at driver init after discovery.
1955 	 */
1956 	sc->track_mapping_events = 0;
1957 
1958 	/*
1959 	 * callout synchronization
1960 	 * This is used to prevent race conditions for the callout.
1961 	 */
1962 	mps_dprint(sc, MPS_MAPPING, "%s: Start check for missing devices.\n",
1963 	    __func__);
1964 	mtx_assert(&sc->mps_mtx, MA_OWNED);
1965 	if ((callout_pending(&sc->device_check_callout)) ||
1966 	    (!callout_active(&sc->device_check_callout))) {
1967 		mps_dprint(sc, MPS_MAPPING, "%s: Device Check Callout is "
1968 		    "already pending or not active.\n", __func__);
1969 		return;
1970 	}
1971 	callout_deactivate(&sc->device_check_callout);
1972 
1973 	/*
1974 	 * Use callout to check if any devices in the mapping table have been
1975 	 * processed yet. If ALL devices are marked as not init_complete, no
1976 	 * devices have been processed and mapped. Until devices are mapped
1977 	 * there's no reason to mark them as missing. Continue resetting this
1978 	 * callout until devices have been mapped.
1979 	 */
1980 	if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
1981 	    MPI2_IOCPAGE8_FLAGS_ENCLOSURE_SLOT_MAPPING) {
1982 		et_entry = sc->enclosure_table;
1983 		for (i = 0; i < sc->num_enc_table_entries; i++, et_entry++) {
1984 			if (et_entry->init_complete) {
1985 				stop_device_checks = 1;
1986 				break;
1987 			}
1988 		}
1989 	} else if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
1990 	    MPI2_IOCPAGE8_FLAGS_DEVICE_PERSISTENCE_MAPPING) {
1991 		mt_entry = sc->mapping_table;
1992 		for (i = 0; i < sc->max_devices; i++, mt_entry++) {
1993 			if (mt_entry->init_complete) {
1994 				stop_device_checks = 1;
1995 				break;
1996 			}
1997 		}
1998 	}
1999 
2000 	/*
2001 	 * Setup another callout check after a delay. Keep doing this until
2002 	 * devices are mapped.
2003 	 */
2004 	if (!stop_device_checks) {
2005 		mps_dprint(sc, MPS_MAPPING, "%s: No devices have been mapped. "
2006 		    "Reset callout to check again after a %d second delay.\n",
2007 		    __func__, MPS_MISSING_CHECK_DELAY);
2008 		callout_reset(&sc->device_check_callout,
2009 		    MPS_MISSING_CHECK_DELAY * hz, mps_mapping_check_devices,
2010 		    sc);
2011 		return;
2012 	}
2013 	mps_dprint(sc, MPS_MAPPING, "%s: Device check complete.\n", __func__);
2014 
2015 	/*
2016 	 * Depending on the mapping type, check if devices have been processed
2017 	 * and update their missing counts if not processed.
2018 	 */
2019 	if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
2020 	    MPI2_IOCPAGE8_FLAGS_ENCLOSURE_SLOT_MAPPING) {
2021 		et_entry = sc->enclosure_table;
2022 		for (i = 0; i < sc->num_enc_table_entries; i++, et_entry++) {
2023 			if (!et_entry->init_complete) {
2024 				if (et_entry->missing_count <
2025 				    MPS_MAX_MISSING_COUNT) {
2026 					mps_dprint(sc, MPS_MAPPING, "%s: "
2027 					    "Enclosure %d is missing from the "
2028 					    "topology. Update its missing "
2029 					    "count.\n", __func__, i);
2030 					et_entry->missing_count++;
2031 					if (et_entry->dpm_entry_num !=
2032 					    MPS_DPM_BAD_IDX) {
2033 						_mapping_commit_enc_entry(sc,
2034 						    et_entry);
2035 					}
2036 				}
2037 				et_entry->init_complete = 1;
2038 			}
2039 		}
2040 		if (!sc->ir_firmware)
2041 			return;
2042 		_mapping_get_ir_maprange(sc, &start_idx, &end_idx);
2043 		mt_entry = &sc->mapping_table[start_idx];
2044 	} else if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) ==
2045 	    MPI2_IOCPAGE8_FLAGS_DEVICE_PERSISTENCE_MAPPING) {
2046 		start_idx = 0;
2047 		end_idx = sc->max_devices - 1;
2048 		mt_entry = sc->mapping_table;
2049 	}
2050 
2051 	/*
2052 	 * The start and end indices have been set above according to the
2053 	 * mapping type. Go through these mappings and update any entries that
2054 	 * do not have the init_complete flag set, which means they are missing.
2055 	 */
2056 	if (end_idx == 0)
2057 		return;
2058 	for (i = start_idx; i < (end_idx + 1); i++, mt_entry++) {
2059 		if (mt_entry->device_info & MPS_DEV_RESERVED
2060 		    && !mt_entry->physical_id)
2061 			mt_entry->init_complete = 1;
2062 		else if (mt_entry->device_info & MPS_DEV_RESERVED) {
2063 			if (!mt_entry->init_complete) {
2064 				mps_dprint(sc, MPS_MAPPING, "%s: Device in "
2065 				    "mapping table at index %d is missing from "
2066 				    "topology. Update its missing count.\n",
2067 				    __func__, i);
2068 				if (mt_entry->missing_count <
2069 				    MPS_MAX_MISSING_COUNT) {
2070 					mt_entry->missing_count++;
2071 					if (mt_entry->dpm_entry_num !=
2072 					    MPS_DPM_BAD_IDX) {
2073 						_mapping_commit_map_entry(sc,
2074 						    mt_entry);
2075 					}
2076 				}
2077 				mt_entry->init_complete = 1;
2078 			}
2079 		}
2080 	}
2081 }
2082 
2083 /**
2084  * mps_mapping_initialize - initialize mapping tables
2085  * @sc: per adapter object
2086  *
2087  * Read controller persitant mapping tables into internal data area.
2088  *
2089  * Return 0 for success or non-zero for failure.
2090  */
2091 int
2092 mps_mapping_initialize(struct mps_softc *sc)
2093 {
2094 	uint16_t volume_mapping_flags, dpm_pg0_sz;
2095 	uint32_t i;
2096 	Mpi2ConfigReply_t mpi_reply;
2097 	int error;
2098 	uint8_t retry_count;
2099 	uint16_t ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
2100 
2101 	/* The additional 1 accounts for the virtual enclosure
2102 	 * created for the controller
2103 	 */
2104 	sc->max_enclosures = sc->facts->MaxEnclosures + 1;
2105 	sc->max_expanders = sc->facts->MaxSasExpanders;
2106 	sc->max_volumes = sc->facts->MaxVolumes;
2107 	sc->max_devices = sc->facts->MaxTargets + sc->max_volumes;
2108 	sc->pending_map_events = 0;
2109 	sc->num_enc_table_entries = 0;
2110 	sc->num_rsvd_entries = 0;
2111 	sc->max_dpm_entries = sc->ioc_pg8.MaxPersistentEntries;
2112 	sc->is_dpm_enable = (sc->max_dpm_entries) ? 1 : 0;
2113 	sc->track_mapping_events = 0;
2114 
2115 
2116 	mps_dprint(sc, MPS_MAPPING, "%s: Mapping table has a max of %d entries "
2117 	    "and DPM has a max of %d entries.\n", __func__, sc->max_devices,
2118 	    sc->max_dpm_entries);
2119 	if (ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_DISABLE_PERSISTENT_MAPPING)
2120 		sc->is_dpm_enable = 0;
2121 
2122 	if (ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_RESERVED_TARGETID_0)
2123 		sc->num_rsvd_entries = 1;
2124 
2125 	volume_mapping_flags = sc->ioc_pg8.IRVolumeMappingFlags &
2126 	    MPI2_IOCPAGE8_IRFLAGS_MASK_VOLUME_MAPPING_MODE;
2127 	if (sc->ir_firmware && (volume_mapping_flags ==
2128 	    MPI2_IOCPAGE8_IRFLAGS_LOW_VOLUME_MAPPING))
2129 		sc->num_rsvd_entries += sc->max_volumes;
2130 
2131 	error = mps_mapping_allocate_memory(sc);
2132 	if (error)
2133 		return (error);
2134 
2135 	for (i = 0; i < sc->max_devices; i++)
2136 		_mapping_clear_map_entry(sc->mapping_table + i);
2137 
2138 	for (i = 0; i < sc->max_enclosures; i++)
2139 		_mapping_clear_enc_entry(sc->enclosure_table + i);
2140 
2141 	for (i = 0; i < sc->max_devices; i++) {
2142 		sc->removal_table[i].dev_handle = 0;
2143 		sc->removal_table[i].dpm_entry_num = MPS_DPM_BAD_IDX;
2144 	}
2145 
2146 	memset(sc->dpm_entry_used, 0, sc->max_dpm_entries);
2147 	memset(sc->dpm_flush_entry, 0, sc->max_dpm_entries);
2148 
2149 	if (sc->is_dpm_enable) {
2150 		dpm_pg0_sz = sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER) +
2151 		    (sc->max_dpm_entries *
2152 		     sizeof(MPI2_CONFIG_PAGE_DRIVER_MAP0_ENTRY));
2153 		retry_count = 0;
2154 
2155 retry_read_dpm:
2156 		if (mps_config_get_dpm_pg0(sc, &mpi_reply, sc->dpm_pg0,
2157 		    dpm_pg0_sz)) {
2158 			mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: DPM page "
2159 			    "read failed.\n", __func__);
2160 			if (retry_count < 3) {
2161 				retry_count++;
2162 				goto retry_read_dpm;
2163 			}
2164 			sc->is_dpm_enable = 0;
2165 		}
2166 	}
2167 
2168 	if (sc->is_dpm_enable)
2169 		_mapping_process_dpm_pg0(sc);
2170 	else {
2171 		mps_dprint(sc, MPS_MAPPING, "%s: DPM processing is disabled. "
2172 		    "Device mappings will not persist across reboots or "
2173 		    "resets.\n", __func__);
2174 	}
2175 
2176 	sc->track_mapping_events = 1;
2177 	return 0;
2178 }
2179 
2180 /**
2181  * mps_mapping_exit - clear mapping table and associated memory
2182  * @sc: per adapter object
2183  *
2184  * Returns nothing.
2185  */
2186 void
2187 mps_mapping_exit(struct mps_softc *sc)
2188 {
2189 	_mapping_flush_dpm_pages(sc);
2190 	mps_mapping_free_memory(sc);
2191 }
2192 
2193 /**
2194  * mps_mapping_get_tid - return the target id for sas device and handle
2195  * @sc: per adapter object
2196  * @sas_address: sas address of the device
2197  * @handle: device handle
2198  *
2199  * Returns valid target ID on success or BAD_ID.
2200  */
2201 unsigned int
2202 mps_mapping_get_tid(struct mps_softc *sc, uint64_t sas_address, u16 handle)
2203 {
2204 	u32 map_idx;
2205 	struct dev_mapping_table *mt_entry;
2206 
2207 	for (map_idx = 0; map_idx < sc->max_devices; map_idx++) {
2208 		mt_entry = &sc->mapping_table[map_idx];
2209 		if (mt_entry->dev_handle == handle && mt_entry->physical_id ==
2210 		    sas_address)
2211 			return mt_entry->id;
2212 	}
2213 
2214 	return MPS_MAP_BAD_ID;
2215 }
2216 
2217 /**
2218  * mps_mapping_get_tid_from_handle - find a target id in mapping table using
2219  * only the dev handle.  This is just a wrapper function for the local function
2220  * _mapping_get_mt_idx_from_handle.
2221  * @sc: per adapter object
2222  * @handle: device handle
2223  *
2224  * Returns valid target ID on success or BAD_ID.
2225  */
2226 unsigned int
2227 mps_mapping_get_tid_from_handle(struct mps_softc *sc, u16 handle)
2228 {
2229 	return (_mapping_get_mt_idx_from_handle(sc, handle));
2230 }
2231 
2232 /**
2233  * mps_mapping_get_raid_tid - return the target id for raid device
2234  * @sc: per adapter object
2235  * @wwid: world wide identifier for raid volume
2236  * @volHandle: volume device handle
2237  *
2238  * Returns valid target ID on success or BAD_ID.
2239  */
2240 unsigned int
2241 mps_mapping_get_raid_tid(struct mps_softc *sc, u64 wwid, u16 volHandle)
2242 {
2243 	u32 start_idx, end_idx, map_idx;
2244 	struct dev_mapping_table *mt_entry;
2245 
2246 	_mapping_get_ir_maprange(sc, &start_idx, &end_idx);
2247 	mt_entry = &sc->mapping_table[start_idx];
2248 	for (map_idx  = start_idx; map_idx <= end_idx; map_idx++, mt_entry++) {
2249 		if (mt_entry->dev_handle == volHandle &&
2250 		    mt_entry->physical_id == wwid)
2251 			return mt_entry->id;
2252 	}
2253 
2254 	return MPS_MAP_BAD_ID;
2255 }
2256 
2257 /**
2258  * mps_mapping_get_raid_tid_from_handle - find raid device in mapping table
2259  * using only the volume dev handle.  This is just a wrapper function for the
2260  * local function _mapping_get_ir_mt_idx_from_handle.
2261  * @sc: per adapter object
2262  * @volHandle: volume device handle
2263  *
2264  * Returns valid target ID on success or BAD_ID.
2265  */
2266 unsigned int
2267 mps_mapping_get_raid_tid_from_handle(struct mps_softc *sc, u16 volHandle)
2268 {
2269 	return (_mapping_get_ir_mt_idx_from_handle(sc, volHandle));
2270 }
2271 
2272 /**
2273  * mps_mapping_enclosure_dev_status_change_event - handle enclosure events
2274  * @sc: per adapter object
2275  * @event_data: event data payload
2276  *
2277  * Return nothing.
2278  */
2279 void
2280 mps_mapping_enclosure_dev_status_change_event(struct mps_softc *sc,
2281     Mpi2EventDataSasEnclDevStatusChange_t *event_data)
2282 {
2283 	u8 enc_idx, missing_count;
2284 	struct enc_mapping_table *et_entry;
2285 	Mpi2DriverMap0Entry_t *dpm_entry;
2286 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
2287 	u8 map_shift = MPI2_DRVMAP0_MAPINFO_SLOT_SHIFT;
2288 	u8 update_phy_bits = 0;
2289 	u32 saved_phy_bits;
2290 	uint64_t temp64_var;
2291 
2292 	if ((ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_MASK_MAPPING_MODE) !=
2293 	    MPI2_IOCPAGE8_FLAGS_ENCLOSURE_SLOT_MAPPING)
2294 		goto out;
2295 
2296 	dpm_entry = (Mpi2DriverMap0Entry_t *)((u8 *)sc->dpm_pg0 +
2297 	    sizeof(MPI2_CONFIG_EXTENDED_PAGE_HEADER));
2298 
2299 	if (event_data->ReasonCode == MPI2_EVENT_SAS_ENCL_RC_ADDED) {
2300 		if (!event_data->NumSlots) {
2301 			mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: Enclosure "
2302 			    "with handle = 0x%x reported 0 slots.\n", __func__,
2303 			    le16toh(event_data->EnclosureHandle));
2304 			goto out;
2305 		}
2306 		temp64_var = event_data->EnclosureLogicalID.High;
2307 		temp64_var = (temp64_var << 32) |
2308 		    event_data->EnclosureLogicalID.Low;
2309 		enc_idx = _mapping_get_enc_idx_from_id(sc, temp64_var,
2310 		    event_data->PhyBits);
2311 
2312 		/*
2313 		 * If the Added enclosure is already in the Enclosure Table,
2314 		 * make sure that all the the enclosure info is up to date. If
2315 		 * the enclosure was missing and has just been added back, or if
2316 		 * the enclosure's Phy Bits have changed, clear the missing
2317 		 * count and update the Phy Bits in the mapping table and in the
2318 		 * DPM, if it's being used.
2319 		 */
2320 		if (enc_idx != MPS_ENCTABLE_BAD_IDX) {
2321 			et_entry = &sc->enclosure_table[enc_idx];
2322 			if (et_entry->init_complete &&
2323 			    !et_entry->missing_count) {
2324 				mps_dprint(sc, MPS_MAPPING, "%s: Enclosure %d "
2325 				    "is already present with handle = 0x%x\n",
2326 				    __func__, enc_idx, et_entry->enc_handle);
2327 				goto out;
2328 			}
2329 			et_entry->enc_handle = le16toh(event_data->
2330 			    EnclosureHandle);
2331 			et_entry->start_slot = le16toh(event_data->StartSlot);
2332 			saved_phy_bits = et_entry->phy_bits;
2333 			et_entry->phy_bits |= le32toh(event_data->PhyBits);
2334 			if (saved_phy_bits != et_entry->phy_bits)
2335 				update_phy_bits = 1;
2336 			if (et_entry->missing_count || update_phy_bits) {
2337 				et_entry->missing_count = 0;
2338 				if (sc->is_dpm_enable &&
2339 				    et_entry->dpm_entry_num !=
2340 				    MPS_DPM_BAD_IDX) {
2341 					dpm_entry += et_entry->dpm_entry_num;
2342 					missing_count =
2343 					    (u8)(dpm_entry->MappingInformation &
2344 					    MPI2_DRVMAP0_MAPINFO_MISSING_MASK);
2345 					if (missing_count || update_phy_bits) {
2346 						dpm_entry->MappingInformation
2347 						    = et_entry->num_slots;
2348 						dpm_entry->MappingInformation
2349 						    <<= map_shift;
2350 						dpm_entry->PhysicalBitsMapping
2351 						    = et_entry->phy_bits;
2352 						sc->dpm_flush_entry[et_entry->
2353 						    dpm_entry_num] = 1;
2354 					}
2355 				}
2356 			}
2357 		} else {
2358 			/*
2359 			 * This is a new enclosure that is being added.
2360 			 * Initialize the Enclosure Table entry. It will be
2361 			 * finalized when a device is added for the enclosure
2362 			 * and the enclosure has enough space in the Mapping
2363 			 * Table to map its devices.
2364 			 */
2365 			enc_idx = sc->num_enc_table_entries;
2366 			if (enc_idx >= sc->max_enclosures) {
2367 				mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: "
2368 				    "Enclosure cannot be added to mapping "
2369 				    "table because it's full.\n", __func__);
2370 				goto out;
2371 			}
2372 			sc->num_enc_table_entries++;
2373 			et_entry = &sc->enclosure_table[enc_idx];
2374 			et_entry->enc_handle = le16toh(event_data->
2375 			    EnclosureHandle);
2376 			et_entry->enclosure_id = le64toh(event_data->
2377 			    EnclosureLogicalID.High);
2378 			et_entry->enclosure_id =
2379 			    ((et_entry->enclosure_id << 32) |
2380 			    le64toh(event_data->EnclosureLogicalID.Low));
2381 			et_entry->start_index = MPS_MAPTABLE_BAD_IDX;
2382 			et_entry->dpm_entry_num = MPS_DPM_BAD_IDX;
2383 			et_entry->num_slots = le16toh(event_data->NumSlots);
2384 			et_entry->start_slot = le16toh(event_data->StartSlot);
2385 			et_entry->phy_bits = le32toh(event_data->PhyBits);
2386 		}
2387 		et_entry->init_complete = 1;
2388 	} else if (event_data->ReasonCode ==
2389 	    MPI2_EVENT_SAS_ENCL_RC_NOT_RESPONDING) {
2390 		/*
2391 		 * An enclosure was removed. Update its missing count and then
2392 		 * update the DPM entry with the new missing count for the
2393 		 * enclosure.
2394 		 */
2395 		enc_idx = _mapping_get_enc_idx_from_handle(sc,
2396 		    le16toh(event_data->EnclosureHandle));
2397 		if (enc_idx == MPS_ENCTABLE_BAD_IDX) {
2398 			mps_dprint(sc, MPS_ERROR | MPS_MAPPING, "%s: Cannot "
2399 			    "unmap enclosure %d because it has already been "
2400 			    "deleted.\n", __func__, enc_idx);
2401 			goto out;
2402 		}
2403 		et_entry = &sc->enclosure_table[enc_idx];
2404 		if (et_entry->missing_count < MPS_MAX_MISSING_COUNT)
2405 			et_entry->missing_count++;
2406 		if (sc->is_dpm_enable &&
2407 		    et_entry->dpm_entry_num != MPS_DPM_BAD_IDX) {
2408 			dpm_entry += et_entry->dpm_entry_num;
2409 			dpm_entry->MappingInformation = et_entry->num_slots;
2410 			dpm_entry->MappingInformation <<= map_shift;
2411 			dpm_entry->MappingInformation |=
2412 			    et_entry->missing_count;
2413 			sc->dpm_flush_entry[et_entry->dpm_entry_num] = 1;
2414 		}
2415 		et_entry->init_complete = 1;
2416 	}
2417 
2418 out:
2419 	_mapping_flush_dpm_pages(sc);
2420 	if (sc->pending_map_events)
2421 		sc->pending_map_events--;
2422 }
2423 
2424 /**
2425  * mps_mapping_topology_change_event - handle topology change events
2426  * @sc: per adapter object
2427  * @event_data: event data payload
2428  *
2429  * Returns nothing.
2430  */
2431 void
2432 mps_mapping_topology_change_event(struct mps_softc *sc,
2433     Mpi2EventDataSasTopologyChangeList_t *event_data)
2434 {
2435 	struct _map_topology_change topo_change;
2436 	struct _map_phy_change *phy_change;
2437 	Mpi2EventSasTopoPhyEntry_t *event_phy_change;
2438 	u8 i, num_entries;
2439 
2440 	topo_change.enc_handle = le16toh(event_data->EnclosureHandle);
2441 	topo_change.exp_handle = le16toh(event_data->ExpanderDevHandle);
2442 	num_entries = event_data->NumEntries;
2443 	topo_change.num_entries = num_entries;
2444 	topo_change.start_phy_num = event_data->StartPhyNum;
2445 	topo_change.num_phys = event_data->NumPhys;
2446 	topo_change.exp_status = event_data->ExpStatus;
2447 	event_phy_change = event_data->PHY;
2448 	topo_change.phy_details = NULL;
2449 
2450 	if (!num_entries)
2451 		goto out;
2452 	phy_change = malloc(sizeof(struct _map_phy_change) * num_entries,
2453 	    M_MPT2, M_NOWAIT|M_ZERO);
2454 	topo_change.phy_details = phy_change;
2455 	if (!phy_change)
2456 		goto out;
2457 	for (i = 0; i < num_entries; i++, event_phy_change++, phy_change++) {
2458 		phy_change->dev_handle = le16toh(event_phy_change->
2459 		    AttachedDevHandle);
2460 		phy_change->reason = event_phy_change->PhyStatus &
2461 		    MPI2_EVENT_SAS_TOPO_RC_MASK;
2462 	}
2463 	_mapping_update_missing_count(sc, &topo_change);
2464 	_mapping_get_dev_info(sc, &topo_change);
2465 	_mapping_clear_removed_entries(sc);
2466 	_mapping_add_new_device(sc, &topo_change);
2467 
2468 out:
2469 	free(topo_change.phy_details, M_MPT2);
2470 	_mapping_flush_dpm_pages(sc);
2471 	if (sc->pending_map_events)
2472 		sc->pending_map_events--;
2473 }
2474 
2475 /**
2476  * mps_mapping_ir_config_change_event - handle IR config change list events
2477  * @sc: per adapter object
2478  * @event_data: event data payload
2479  *
2480  * Returns nothing.
2481  */
2482 void
2483 mps_mapping_ir_config_change_event(struct mps_softc *sc,
2484     Mpi2EventDataIrConfigChangeList_t *event_data)
2485 {
2486 	Mpi2EventIrConfigElement_t *element;
2487 	int i;
2488 	u64 *wwid_table;
2489 	u32 map_idx, flags;
2490 	struct dev_mapping_table *mt_entry;
2491 	u16 element_flags;
2492 
2493 	wwid_table = malloc(sizeof(u64) * event_data->NumElements, M_MPT2,
2494 	    M_NOWAIT | M_ZERO);
2495 	if (!wwid_table)
2496 		goto out;
2497 	element = (Mpi2EventIrConfigElement_t *)&event_data->ConfigElement[0];
2498 	flags = le32toh(event_data->Flags);
2499 
2500 	/*
2501 	 * For volume changes, get the WWID for the volume and put it in a
2502 	 * table to be used in the processing of the IR change event.
2503 	 */
2504 	for (i = 0; i < event_data->NumElements; i++, element++) {
2505 		element_flags = le16toh(element->ElementFlags);
2506 		if ((element->ReasonCode != MPI2_EVENT_IR_CHANGE_RC_ADDED) &&
2507 		    (element->ReasonCode != MPI2_EVENT_IR_CHANGE_RC_REMOVED) &&
2508 		    (element->ReasonCode != MPI2_EVENT_IR_CHANGE_RC_NO_CHANGE)
2509 		    && (element->ReasonCode !=
2510 			MPI2_EVENT_IR_CHANGE_RC_VOLUME_CREATED))
2511 			continue;
2512 		if ((element_flags &
2513 		    MPI2_EVENT_IR_CHANGE_EFLAGS_ELEMENT_TYPE_MASK) ==
2514 		    MPI2_EVENT_IR_CHANGE_EFLAGS_VOLUME_ELEMENT) {
2515 			mps_config_get_volume_wwid(sc,
2516 			    le16toh(element->VolDevHandle), &wwid_table[i]);
2517 		}
2518 	}
2519 
2520 	/*
2521 	 * Check the ReasonCode for each element in the IR event and Add/Remove
2522 	 * Volumes or Physical Disks of Volumes to/from the mapping table. Use
2523 	 * the WWIDs gotten above in wwid_table.
2524 	 */
2525 	if (flags == MPI2_EVENT_IR_CHANGE_FLAGS_FOREIGN_CONFIG)
2526 		goto out;
2527 	else {
2528 		element = (Mpi2EventIrConfigElement_t *)&event_data->
2529 		    ConfigElement[0];
2530 		for (i = 0; i < event_data->NumElements; i++, element++) {
2531 			if (element->ReasonCode ==
2532 			    MPI2_EVENT_IR_CHANGE_RC_ADDED ||
2533 			    element->ReasonCode ==
2534 			    MPI2_EVENT_IR_CHANGE_RC_VOLUME_CREATED) {
2535 				map_idx = _mapping_get_ir_mt_idx_from_wwid
2536 				    (sc, wwid_table[i]);
2537 				if (map_idx != MPS_MAPTABLE_BAD_IDX) {
2538 					/*
2539 					 * The volume is already in the mapping
2540 					 * table. Just update it's info.
2541 					 */
2542 					mt_entry = &sc->mapping_table[map_idx];
2543 					mt_entry->id = map_idx;
2544 					mt_entry->dev_handle = le16toh
2545 					    (element->VolDevHandle);
2546 					mt_entry->device_info =
2547 					    MPS_DEV_RESERVED | MPS_MAP_IN_USE;
2548 					_mapping_update_ir_missing_cnt(sc,
2549 					    map_idx, element, wwid_table[i]);
2550 					continue;
2551 				}
2552 
2553 				/*
2554 				 * Volume is not in mapping table yet. Find a
2555 				 * free entry in the mapping table at the
2556 				 * volume mapping locations. If no entries are
2557 				 * available, this is an error because it means
2558 				 * there are more volumes than can be mapped
2559 				 * and that should never happen for volumes.
2560 				 */
2561 				map_idx = _mapping_get_free_ir_mt_idx(sc);
2562 				if (map_idx == MPS_MAPTABLE_BAD_IDX)
2563 				{
2564 					mps_dprint(sc, MPS_ERROR | MPS_MAPPING,
2565 					    "%s: failed to add the volume with "
2566 					    "handle 0x%04x because there is no "
2567 					    "free space available in the "
2568 					    "mapping table\n", __func__,
2569 					    le16toh(element->VolDevHandle));
2570 					continue;
2571 				}
2572 				mt_entry = &sc->mapping_table[map_idx];
2573 				mt_entry->physical_id = wwid_table[i];
2574 				mt_entry->id = map_idx;
2575 				mt_entry->dev_handle = le16toh(element->
2576 				    VolDevHandle);
2577 				mt_entry->device_info = MPS_DEV_RESERVED |
2578 				    MPS_MAP_IN_USE;
2579 				_mapping_update_ir_missing_cnt(sc, map_idx,
2580 				    element, wwid_table[i]);
2581 			} else if (element->ReasonCode ==
2582 			    MPI2_EVENT_IR_CHANGE_RC_REMOVED) {
2583 				map_idx = _mapping_get_ir_mt_idx_from_wwid(sc,
2584 				    wwid_table[i]);
2585 				if (map_idx == MPS_MAPTABLE_BAD_IDX) {
2586 					mps_dprint(sc, MPS_MAPPING,"%s: Failed "
2587 					    "to remove a volume because it has "
2588 					    "already been removed.\n",
2589 					    __func__);
2590 					continue;
2591 				}
2592 				_mapping_update_ir_missing_cnt(sc, map_idx,
2593 				    element, wwid_table[i]);
2594 			} else if (element->ReasonCode ==
2595 			    MPI2_EVENT_IR_CHANGE_RC_VOLUME_DELETED) {
2596 				map_idx = _mapping_get_mt_idx_from_handle(sc,
2597 				    le16toh(element->VolDevHandle));
2598 				if (map_idx == MPS_MAPTABLE_BAD_IDX) {
2599 					mps_dprint(sc, MPS_MAPPING,"%s: Failed "
2600 					    "to remove volume with handle "
2601 					    "0x%04x because it has already "
2602 					    "been removed.\n", __func__,
2603 					    le16toh(element->VolDevHandle));
2604 					continue;
2605 				}
2606 				mt_entry = &sc->mapping_table[map_idx];
2607 				_mapping_update_ir_missing_cnt(sc, map_idx,
2608 				    element, mt_entry->physical_id);
2609 			}
2610 		}
2611 	}
2612 
2613 out:
2614 	_mapping_flush_dpm_pages(sc);
2615 	free(wwid_table, M_MPT2);
2616 	if (sc->pending_map_events)
2617 		sc->pending_map_events--;
2618 }
2619 
2620 int
2621 mps_mapping_dump(SYSCTL_HANDLER_ARGS)
2622 {
2623 	struct mps_softc *sc;
2624 	struct dev_mapping_table *mt_entry;
2625 	struct sbuf sbuf;
2626 	int i, error;
2627 
2628 	sc = (struct mps_softc *)arg1;
2629 
2630 	error = sysctl_wire_old_buffer(req, 0);
2631 	if (error != 0)
2632 		return (error);
2633 	sbuf_new_for_sysctl(&sbuf, NULL, 128, req);
2634 
2635 	sbuf_printf(&sbuf, "\nindex physical_id       handle id\n");
2636 	for (i = 0; i < sc->max_devices; i++) {
2637 		mt_entry = &sc->mapping_table[i];
2638 		if (mt_entry->physical_id == 0)
2639 			continue;
2640 		sbuf_printf(&sbuf, "%4d  %jx  %04x   %hd\n",
2641 		    i, mt_entry->physical_id, mt_entry->dev_handle,
2642 		    mt_entry->id);
2643 	}
2644 	error = sbuf_finish(&sbuf);
2645 	sbuf_delete(&sbuf);
2646 	return (error);
2647 }
2648 
2649 int
2650 mps_mapping_encl_dump(SYSCTL_HANDLER_ARGS)
2651 {
2652 	struct mps_softc *sc;
2653 	struct enc_mapping_table *enc_entry;
2654 	struct sbuf sbuf;
2655 	int i, error;
2656 
2657 	sc = (struct mps_softc *)arg1;
2658 
2659 	error = sysctl_wire_old_buffer(req, 0);
2660 	if (error != 0)
2661 		return (error);
2662 	sbuf_new_for_sysctl(&sbuf, NULL, 128, req);
2663 
2664 	sbuf_printf(&sbuf, "\nindex enclosure_id      handle map_index\n");
2665 	for (i = 0; i < sc->max_enclosures; i++) {
2666 		enc_entry = &sc->enclosure_table[i];
2667 		if (enc_entry->enclosure_id == 0)
2668 			continue;
2669 		sbuf_printf(&sbuf, "%4d  %jx  %04x   %d\n",
2670 		    i, enc_entry->enclosure_id, enc_entry->enc_handle,
2671 		    enc_entry->start_index);
2672 	}
2673 	error = sbuf_finish(&sbuf);
2674 	sbuf_delete(&sbuf);
2675 	return (error);
2676 }
2677