1 /*- 2 * Copyright (c) 2003, 2004, 2005, 2008 Silicon Graphics International Corp. 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions, and the following disclaimer, 10 * without modification. 11 * 2. Redistributions in binary form must reproduce at minimum a disclaimer 12 * substantially similar to the "NO WARRANTY" disclaimer below 13 * ("Disclaimer") and any redistribution must be conditioned upon 14 * including a substantially similar Disclaimer requirement for further 15 * binary redistribution. 16 * 17 * NO WARRANTY 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 26 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 27 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28 * POSSIBILITY OF SUCH DAMAGES. 29 * 30 * $Id: //depot/users/kenm/FreeBSD-test2/sys/cam/ctl/ctl_private.h#7 $ 31 * $FreeBSD$ 32 */ 33 /* 34 * CAM Target Layer driver private data structures/definitions. 35 * 36 * Author: Ken Merry <ken@FreeBSD.org> 37 */ 38 39 #ifndef _CTL_PRIVATE_H_ 40 #define _CTL_PRIVATE_H_ 41 42 /* 43 * SCSI vendor and product names. 44 */ 45 #define CTL_VENDOR "FREEBSD " 46 #define CTL_DIRECT_PRODUCT "CTLDISK " 47 #define CTL_PROCESSOR_PRODUCT "CTLPROCESSOR " 48 #define CTL_UNKNOWN_PRODUCT "CTLDEVICE " 49 50 struct ctl_fe_ioctl_startstop_info { 51 struct cv sem; 52 struct ctl_hard_startstop_info hs_info; 53 }; 54 55 struct ctl_fe_ioctl_bbrread_info { 56 struct cv sem; 57 struct ctl_bbrread_info *bbr_info; 58 int wakeup_done; 59 struct mtx *lock; 60 }; 61 62 typedef enum { 63 CTL_IOCTL_INPROG, 64 CTL_IOCTL_DATAMOVE, 65 CTL_IOCTL_DONE 66 } ctl_fe_ioctl_state; 67 68 struct ctl_fe_ioctl_params { 69 struct cv sem; 70 struct mtx ioctl_mtx; 71 ctl_fe_ioctl_state state; 72 }; 73 74 #define CTL_POOL_ENTRIES_INTERNAL 200 75 #define CTL_POOL_ENTRIES_EMERGENCY 300 76 #define CTL_POOL_ENTRIES_OTHER_SC 200 77 78 typedef enum { 79 CTL_POOL_INTERNAL, 80 CTL_POOL_FETD, 81 CTL_POOL_EMERGENCY, 82 CTL_POOL_4OTHERSC 83 } ctl_pool_type; 84 85 typedef enum { 86 CTL_POOL_FLAG_NONE = 0x00, 87 CTL_POOL_FLAG_INVALID = 0x01 88 } ctl_pool_flags; 89 90 struct ctl_io_pool { 91 ctl_pool_type type; 92 ctl_pool_flags flags; 93 uint32_t id; 94 struct ctl_softc *ctl_softc; 95 uint32_t refcount; 96 uint64_t total_allocated; 97 uint64_t total_freed; 98 int32_t total_ctl_io; 99 int32_t free_ctl_io; 100 STAILQ_HEAD(, ctl_io_hdr) free_queue; 101 STAILQ_ENTRY(ctl_io_pool) links; 102 }; 103 104 typedef enum { 105 CTL_IOCTL_FLAG_NONE = 0x00, 106 CTL_IOCTL_FLAG_ENABLED = 0x01 107 } ctl_ioctl_flags; 108 109 struct ctl_ioctl_info { 110 ctl_ioctl_flags flags; 111 uint32_t cur_tag_num; 112 struct ctl_port port; 113 char port_name[24]; 114 }; 115 116 typedef enum { 117 CTL_SER_BLOCK, 118 CTL_SER_BLOCKOPT, 119 CTL_SER_EXTENT, 120 CTL_SER_EXTENTOPT, 121 CTL_SER_PASS, 122 CTL_SER_SKIP 123 } ctl_serialize_action; 124 125 typedef enum { 126 CTL_ACTION_BLOCK, 127 CTL_ACTION_OVERLAP, 128 CTL_ACTION_OVERLAP_TAG, 129 CTL_ACTION_PASS, 130 CTL_ACTION_SKIP, 131 CTL_ACTION_ERROR 132 } ctl_action; 133 134 /* 135 * WARNING: Keep the bottom nibble here free, we OR in the data direction 136 * flags for each command. 137 * 138 * Note: "OK_ON_ALL_LUNS" == we don't have to have a lun configured 139 * "OK_ON_BOTH" == we have to have a lun configured 140 * "SA5" == command has 5-bit service action at byte 1 141 */ 142 typedef enum { 143 CTL_CMD_FLAG_NONE = 0x0000, 144 CTL_CMD_FLAG_NO_SENSE = 0x0010, 145 CTL_CMD_FLAG_OK_ON_ALL_LUNS = 0x0020, 146 CTL_CMD_FLAG_ALLOW_ON_RESV = 0x0040, 147 CTL_CMD_FLAG_OK_ON_PROC = 0x0100, 148 CTL_CMD_FLAG_OK_ON_SLUN = 0x0200, 149 CTL_CMD_FLAG_OK_ON_BOTH = 0x0300, 150 CTL_CMD_FLAG_OK_ON_STOPPED = 0x0400, 151 CTL_CMD_FLAG_OK_ON_INOPERABLE = 0x0800, 152 CTL_CMD_FLAG_OK_ON_OFFLINE = 0x1000, 153 CTL_CMD_FLAG_OK_ON_SECONDARY = 0x2000, 154 CTL_CMD_FLAG_ALLOW_ON_PR_RESV = 0x4000, 155 CTL_CMD_FLAG_SA5 = 0x8000 156 } ctl_cmd_flags; 157 158 typedef enum { 159 CTL_SERIDX_TUR = 0, 160 CTL_SERIDX_READ, 161 CTL_SERIDX_WRITE, 162 CTL_SERIDX_UNMAP, 163 CTL_SERIDX_MD_SNS, 164 CTL_SERIDX_MD_SEL, 165 CTL_SERIDX_RQ_SNS, 166 CTL_SERIDX_INQ, 167 CTL_SERIDX_RD_CAP, 168 CTL_SERIDX_RES, 169 CTL_SERIDX_LOG_SNS, 170 CTL_SERIDX_FORMAT, 171 CTL_SERIDX_START, 172 /* TBD: others to be filled in as needed */ 173 CTL_SERIDX_COUNT, /* LAST, not a normal code, provides # codes */ 174 CTL_SERIDX_INVLD = CTL_SERIDX_COUNT 175 } ctl_seridx; 176 177 typedef int ctl_opfunc(struct ctl_scsiio *ctsio); 178 179 struct ctl_cmd_entry { 180 ctl_opfunc *execute; 181 ctl_seridx seridx; 182 ctl_cmd_flags flags; 183 ctl_lun_error_pattern pattern; 184 uint8_t length; /* CDB length */ 185 uint8_t usage[15]; /* Mask of allowed CDB bits 186 * after the opcode byte. */ 187 }; 188 189 typedef enum { 190 CTL_LUN_NONE = 0x000, 191 CTL_LUN_CONTROL = 0x001, 192 CTL_LUN_RESERVED = 0x002, 193 CTL_LUN_INVALID = 0x004, 194 CTL_LUN_DISABLED = 0x008, 195 CTL_LUN_MALLOCED = 0x010, 196 CTL_LUN_STOPPED = 0x020, 197 CTL_LUN_INOPERABLE = 0x040, 198 CTL_LUN_OFFLINE = 0x080, 199 CTL_LUN_PR_RESERVED = 0x100, 200 CTL_LUN_PRIMARY_SC = 0x200, 201 CTL_LUN_SENSE_DESC = 0x400, 202 CTL_LUN_READONLY = 0x800 203 } ctl_lun_flags; 204 205 typedef enum { 206 CTLBLOCK_FLAG_NONE = 0x00, 207 CTLBLOCK_FLAG_INVALID = 0x01 208 } ctlblock_flags; 209 210 union ctl_softcs { 211 struct ctl_softc *ctl_softc; 212 struct ctlblock_softc *ctlblock_softc; 213 }; 214 215 /* 216 * Mode page defaults. 217 */ 218 #if 0 219 /* 220 * These values make Solaris trim off some of the capacity. 221 */ 222 #define CTL_DEFAULT_SECTORS_PER_TRACK 63 223 #define CTL_DEFAULT_HEADS 255 224 /* 225 * These values seem to work okay. 226 */ 227 #define CTL_DEFAULT_SECTORS_PER_TRACK 63 228 #define CTL_DEFAULT_HEADS 16 229 /* 230 * These values work reasonably well. 231 */ 232 #define CTL_DEFAULT_SECTORS_PER_TRACK 512 233 #define CTL_DEFAULT_HEADS 64 234 #endif 235 236 /* 237 * Solaris is somewhat picky about how many heads and sectors per track you 238 * have defined in mode pages 3 and 4. These values seem to cause Solaris 239 * to get the capacity more or less right when you run the format tool. 240 * They still have problems when dealing with devices larger than 1TB, 241 * but there isn't anything we can do about that. 242 * 243 * For smaller LUN sizes, this ends up causing the number of cylinders to 244 * work out to 0. Solaris actually recognizes that and comes up with its 245 * own bogus geometry to fit the actual capacity of the drive. They really 246 * should just give up on geometry and stick to the read capacity 247 * information alone for modern disk drives. 248 * 249 * One thing worth mentioning about Solaris' mkfs command is that it 250 * doesn't like sectors per track values larger than 256. 512 seems to 251 * work okay for format, but causes problems when you try to make a 252 * filesystem. 253 * 254 * Another caveat about these values: the product of these two values 255 * really should be a power of 2. This is because of the simplistic 256 * shift-based calculation that we have to use on the i386 platform to 257 * calculate the number of cylinders here. (If you use a divide, you end 258 * up calling __udivdi3(), which is a hardware FP call on the PC. On the 259 * XScale, it is done in software, so you can do that from inside the 260 * kernel.) 261 * 262 * So for the current values (256 S/T, 128 H), we get 32768, which works 263 * very nicely for calculating cylinders. 264 * 265 * If you want to change these values so that their product is no longer a 266 * power of 2, re-visit the calculation in ctl_init_page_index(). You may 267 * need to make it a bit more complicated to get the number of cylinders 268 * right. 269 */ 270 #define CTL_DEFAULT_SECTORS_PER_TRACK 256 271 #define CTL_DEFAULT_HEADS 128 272 273 #define CTL_DEFAULT_ROTATION_RATE 10000 274 275 struct ctl_page_index; 276 277 typedef int ctl_modesen_handler(struct ctl_scsiio *ctsio, 278 struct ctl_page_index *page_index, 279 int pc); 280 typedef int ctl_modesel_handler(struct ctl_scsiio *ctsio, 281 struct ctl_page_index *page_index, 282 uint8_t *page_ptr); 283 284 typedef enum { 285 CTL_PAGE_FLAG_NONE = 0x00, 286 CTL_PAGE_FLAG_DISK_ONLY = 0x01 287 } ctl_page_flags; 288 289 struct ctl_page_index { 290 uint8_t page_code; 291 uint8_t subpage; 292 uint16_t page_len; 293 uint8_t *page_data; 294 ctl_page_flags page_flags; 295 ctl_modesen_handler *sense_handler; 296 ctl_modesel_handler *select_handler; 297 }; 298 299 #define CTL_PAGE_CURRENT 0x00 300 #define CTL_PAGE_CHANGEABLE 0x01 301 #define CTL_PAGE_DEFAULT 0x02 302 #define CTL_PAGE_SAVED 0x03 303 304 static const struct ctl_page_index page_index_template[] = { 305 {SMS_FORMAT_DEVICE_PAGE, 0, sizeof(struct scsi_format_page), NULL, 306 CTL_PAGE_FLAG_DISK_ONLY, NULL, NULL}, 307 {SMS_RIGID_DISK_PAGE, 0, sizeof(struct scsi_rigid_disk_page), NULL, 308 CTL_PAGE_FLAG_DISK_ONLY, NULL, NULL}, 309 {SMS_CACHING_PAGE, 0, sizeof(struct scsi_caching_page), NULL, 310 CTL_PAGE_FLAG_DISK_ONLY, NULL, ctl_caching_sp_handler}, 311 {SMS_CONTROL_MODE_PAGE, 0, sizeof(struct scsi_control_page), NULL, 312 CTL_PAGE_FLAG_NONE, NULL, ctl_control_page_handler}, 313 {SMS_VENDOR_SPECIFIC_PAGE | SMPH_SPF, PWR_SUBPAGE_CODE, 314 sizeof(struct copan_power_subpage), NULL, CTL_PAGE_FLAG_NONE, 315 ctl_power_sp_sense_handler, ctl_power_sp_handler}, 316 {SMS_VENDOR_SPECIFIC_PAGE | SMPH_SPF, APS_SUBPAGE_CODE, 317 sizeof(struct copan_aps_subpage), NULL, CTL_PAGE_FLAG_NONE, 318 NULL, ctl_aps_sp_handler}, 319 {SMS_VENDOR_SPECIFIC_PAGE | SMPH_SPF, DBGCNF_SUBPAGE_CODE, 320 sizeof(struct copan_debugconf_subpage), NULL, CTL_PAGE_FLAG_NONE, 321 ctl_debugconf_sp_sense_handler, ctl_debugconf_sp_select_handler}, 322 }; 323 324 #define CTL_NUM_MODE_PAGES sizeof(page_index_template)/ \ 325 sizeof(page_index_template[0]) 326 327 struct ctl_mode_pages { 328 struct scsi_format_page format_page[4]; 329 struct scsi_rigid_disk_page rigid_disk_page[4]; 330 struct scsi_caching_page caching_page[4]; 331 struct scsi_control_page control_page[4]; 332 struct copan_power_subpage power_subpage[4]; 333 struct copan_aps_subpage aps_subpage[4]; 334 struct copan_debugconf_subpage debugconf_subpage[4]; 335 struct ctl_page_index index[CTL_NUM_MODE_PAGES]; 336 }; 337 338 struct ctl_lun_delay_info { 339 ctl_delay_type datamove_type; 340 uint32_t datamove_delay; 341 ctl_delay_type done_type; 342 uint32_t done_delay; 343 }; 344 345 typedef enum { 346 CTL_ERR_INJ_NONE = 0x00, 347 CTL_ERR_INJ_ABORTED = 0x01 348 } ctl_err_inject_flags; 349 350 typedef enum { 351 CTL_PR_FLAG_NONE = 0x00, 352 CTL_PR_FLAG_REGISTERED = 0x01, 353 CTL_PR_FLAG_ACTIVE_RES = 0x02 354 } ctl_per_res_flags; 355 356 #define CTL_PR_ALL_REGISTRANTS 0xFFFFFFFF 357 #define CTL_PR_NO_RESERVATION 0xFFFFFFF0 358 359 struct ctl_devid { 360 int len; 361 uint8_t data[]; 362 }; 363 364 /* 365 * For report target port groups. 366 */ 367 #define NUM_TARGET_PORT_GROUPS 2 368 369 struct tpc_list; 370 struct ctl_lun { 371 struct mtx lun_lock; 372 struct ctl_id target; 373 uint64_t lun; 374 ctl_lun_flags flags; 375 STAILQ_HEAD(,ctl_error_desc) error_list; 376 uint64_t error_serial; 377 struct ctl_softc *ctl_softc; 378 struct ctl_be_lun *be_lun; 379 struct ctl_backend_driver *backend; 380 int io_count; 381 struct ctl_lun_delay_info delay_info; 382 int sync_interval; 383 int sync_count; 384 TAILQ_HEAD(ctl_ooaq, ctl_io_hdr) ooa_queue; 385 TAILQ_HEAD(ctl_blockq,ctl_io_hdr) blocked_queue; 386 STAILQ_ENTRY(ctl_lun) links; 387 STAILQ_ENTRY(ctl_lun) run_links; 388 #ifdef CTL_WITH_CA 389 uint32_t have_ca[CTL_MAX_INITIATORS >> 5]; 390 struct scsi_sense_data pending_sense[CTL_MAX_INITIATORS]; 391 #endif 392 ctl_ua_type pending_ua[CTL_MAX_INITIATORS]; 393 struct ctl_mode_pages mode_pages; 394 struct ctl_lun_io_stats stats; 395 uint32_t res_idx; 396 unsigned int PRGeneration; 397 uint64_t pr_keys[2*CTL_MAX_INITIATORS]; 398 int pr_key_count; 399 uint32_t pr_res_idx; 400 uint8_t res_type; 401 uint8_t write_buffer[262144]; 402 struct ctl_devid *lun_devid; 403 TAILQ_HEAD(tpc_lists, tpc_list) tpc_lists; 404 }; 405 406 typedef enum { 407 CTL_FLAG_REAL_SYNC = 0x02, 408 CTL_FLAG_MASTER_SHELF = 0x04 409 } ctl_gen_flags; 410 411 #define CTL_MAX_THREADS 16 412 413 struct ctl_thread { 414 struct mtx_padalign queue_lock; 415 struct ctl_softc *ctl_softc; 416 struct thread *thread; 417 STAILQ_HEAD(, ctl_io_hdr) incoming_queue; 418 STAILQ_HEAD(, ctl_io_hdr) rtr_queue; 419 STAILQ_HEAD(, ctl_io_hdr) done_queue; 420 STAILQ_HEAD(, ctl_io_hdr) isc_queue; 421 }; 422 423 struct tpc_token; 424 struct ctl_softc { 425 struct mtx ctl_lock; 426 struct cdev *dev; 427 int open_count; 428 struct ctl_id target; 429 int num_disks; 430 int num_luns; 431 ctl_gen_flags flags; 432 ctl_ha_mode ha_mode; 433 int inquiry_pq_no_lun; 434 struct sysctl_ctx_list sysctl_ctx; 435 struct sysctl_oid *sysctl_tree; 436 struct ctl_ioctl_info ioctl_info; 437 struct ctl_io_pool *internal_pool; 438 struct ctl_io_pool *emergency_pool; 439 struct ctl_io_pool *othersc_pool; 440 struct proc *ctl_proc; 441 int targ_online; 442 uint32_t ctl_lun_mask[(CTL_MAX_LUNS + 31) / 32]; 443 struct ctl_lun *ctl_luns[CTL_MAX_LUNS]; 444 uint32_t ctl_port_mask[(CTL_MAX_PORTS + 31) / 32]; 445 uint64_t aps_locked_lun; 446 STAILQ_HEAD(, ctl_lun) lun_list; 447 STAILQ_HEAD(, ctl_be_lun) pending_lun_queue; 448 uint32_t num_frontends; 449 STAILQ_HEAD(, ctl_frontend) fe_list; 450 uint32_t num_ports; 451 STAILQ_HEAD(, ctl_port) port_list; 452 struct ctl_port *ctl_ports[CTL_MAX_PORTS]; 453 uint32_t num_backends; 454 STAILQ_HEAD(, ctl_backend_driver) be_list; 455 struct mtx pool_lock; 456 uint32_t num_pools; 457 uint32_t cur_pool_id; 458 STAILQ_HEAD(, ctl_io_pool) io_pools; 459 time_t last_print_jiffies; 460 uint32_t skipped_prints; 461 struct ctl_thread threads[CTL_MAX_THREADS]; 462 TAILQ_HEAD(tpc_tokens, tpc_token) tpc_tokens; 463 struct callout tpc_timeout; 464 }; 465 466 #ifdef _KERNEL 467 468 extern const struct ctl_cmd_entry ctl_cmd_table[256]; 469 470 uint32_t ctl_get_initindex(struct ctl_nexus *nexus); 471 uint32_t ctl_get_resindex(struct ctl_nexus *nexus); 472 uint32_t ctl_port_idx(int port_num); 473 int ctl_pool_create(struct ctl_softc *ctl_softc, ctl_pool_type pool_type, 474 uint32_t total_ctl_io, struct ctl_io_pool **npool); 475 void ctl_pool_free(struct ctl_io_pool *pool); 476 int ctl_scsi_release(struct ctl_scsiio *ctsio); 477 int ctl_scsi_reserve(struct ctl_scsiio *ctsio); 478 int ctl_start_stop(struct ctl_scsiio *ctsio); 479 int ctl_sync_cache(struct ctl_scsiio *ctsio); 480 int ctl_format(struct ctl_scsiio *ctsio); 481 int ctl_read_buffer(struct ctl_scsiio *ctsio); 482 int ctl_write_buffer(struct ctl_scsiio *ctsio); 483 int ctl_write_same(struct ctl_scsiio *ctsio); 484 int ctl_unmap(struct ctl_scsiio *ctsio); 485 int ctl_mode_select(struct ctl_scsiio *ctsio); 486 int ctl_mode_sense(struct ctl_scsiio *ctsio); 487 int ctl_read_capacity(struct ctl_scsiio *ctsio); 488 int ctl_read_capacity_16(struct ctl_scsiio *ctsio); 489 int ctl_read_write(struct ctl_scsiio *ctsio); 490 int ctl_cnw(struct ctl_scsiio *ctsio); 491 int ctl_report_luns(struct ctl_scsiio *ctsio); 492 int ctl_request_sense(struct ctl_scsiio *ctsio); 493 int ctl_tur(struct ctl_scsiio *ctsio); 494 int ctl_verify(struct ctl_scsiio *ctsio); 495 int ctl_inquiry(struct ctl_scsiio *ctsio); 496 int ctl_persistent_reserve_in(struct ctl_scsiio *ctsio); 497 int ctl_persistent_reserve_out(struct ctl_scsiio *ctsio); 498 int ctl_report_tagret_port_groups(struct ctl_scsiio *ctsio); 499 int ctl_report_supported_opcodes(struct ctl_scsiio *ctsio); 500 int ctl_report_supported_tmf(struct ctl_scsiio *ctsio); 501 int ctl_report_timestamp(struct ctl_scsiio *ctsio); 502 int ctl_isc(struct ctl_scsiio *ctsio); 503 504 void ctl_tpc_init(struct ctl_softc *softc); 505 void ctl_tpc_shutdown(struct ctl_softc *softc); 506 void ctl_tpc_lun_init(struct ctl_lun *lun); 507 void ctl_tpc_lun_shutdown(struct ctl_lun *lun); 508 int ctl_inquiry_evpd_tpc(struct ctl_scsiio *ctsio, int alloc_len); 509 int ctl_receive_copy_status_lid1(struct ctl_scsiio *ctsio); 510 int ctl_receive_copy_failure_details(struct ctl_scsiio *ctsio); 511 int ctl_receive_copy_status_lid4(struct ctl_scsiio *ctsio); 512 int ctl_receive_copy_operating_parameters(struct ctl_scsiio *ctsio); 513 int ctl_extended_copy_lid1(struct ctl_scsiio *ctsio); 514 int ctl_extended_copy_lid4(struct ctl_scsiio *ctsio); 515 int ctl_copy_operation_abort(struct ctl_scsiio *ctsio); 516 int ctl_populate_token(struct ctl_scsiio *ctsio); 517 int ctl_write_using_token(struct ctl_scsiio *ctsio); 518 int ctl_receive_rod_token_information(struct ctl_scsiio *ctsio); 519 int ctl_report_all_rod_tokens(struct ctl_scsiio *ctsio); 520 521 #endif /* _KERNEL */ 522 523 #endif /* _CTL_PRIVATE_H_ */ 524 525 /* 526 * vim: ts=8 527 */ 528