2 * Copyright (c) 2012 Intel Corporation. All rights reserved.
3 * Copyright (c) 2006 - 2012 QLogic Corporation. All rights reserved.
4 * Copyright (c) 2003, 2004, 2005, 2006 PathScale, Inc. All rights reserved.
6 * This software is available to you under a choice of one of two
7 * licenses. You may choose to be licensed under the terms of the GNU
8 * General Public License (GPL) Version 2, available from the file
9 * COPYING in the main directory of this source tree, or the
10 * OpenIB.org BSD license below:
12 * Redistribution and use in source and binary forms, with or
13 * without modification, are permitted provided that the following
16 * - Redistributions of source code must retain the above
17 * copyright notice, this list of conditions and the following
20 * - Redistributions in binary form must reproduce the above
21 * copyright notice, this list of conditions and the following
22 * disclaimer in the documentation and/or other materials
23 * provided with the distribution.
25 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
26 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
27 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
28 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
29 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
30 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
31 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
36 * This file contains support for diagnostic functions. It is accessed by
37 * opening the qib_diag device, normally minor number 129. Diagnostic use
38 * of the QLogic_IB chip may render the chip or board unusable until the
39 * driver is unloaded, or in some cases, until the system is rebooted.
41 * Accesses to the chip through this interface are not similar to going
42 * through the /sys/bus/pci resource mmap interface.
46 #include <linux/pci.h>
47 #include <linux/poll.h>
48 #include <linux/vmalloc.h>
49 #include <linux/export.h>
51 #include <linux/uaccess.h>
54 #include "qib_common.h"
57 #define pr_fmt(fmt) QIB_DRV_NAME ": " fmt
60 * Each client that opens the diag device must read then write
61 * offset 0, to prevent lossage from random cat or od. diag_state
62 * sequences this "handshake".
64 enum diag_state
{ UNUSED
= 0, OPENED
, INIT
, READY
};
66 /* State for an individual client. PID so children cannot abuse handshake */
67 static struct qib_diag_client
{
68 struct qib_diag_client
*next
;
69 struct qib_devdata
*dd
;
71 enum diag_state state
;
75 * Get a client struct. Recycled if possible, else kmalloc.
76 * Must be called with qib_mutex held
78 static struct qib_diag_client
*get_client(struct qib_devdata
*dd
)
80 struct qib_diag_client
*dc
;
84 /* got from pool remove it and use */
85 client_pool
= dc
->next
;
87 /* None in pool, alloc and init */
88 dc
= kmalloc(sizeof(*dc
), GFP_KERNEL
);
93 dc
->pid
= current
->pid
;
100 * Return to pool. Must be called with qib_mutex held
102 static void return_client(struct qib_diag_client
*dc
)
104 struct qib_devdata
*dd
= dc
->dd
;
105 struct qib_diag_client
*tdc
, *rdc
;
108 if (dc
== dd
->diag_client
) {
109 dd
->diag_client
= dc
->next
;
112 tdc
= dc
->dd
->diag_client
;
114 if (dc
== tdc
->next
) {
115 tdc
->next
= dc
->next
;
126 rdc
->next
= client_pool
;
131 static int qib_diag_open(struct inode
*in
, struct file
*fp
);
132 static int qib_diag_release(struct inode
*in
, struct file
*fp
);
133 static ssize_t
qib_diag_read(struct file
*fp
, char __user
*data
,
134 size_t count
, loff_t
*off
);
135 static ssize_t
qib_diag_write(struct file
*fp
, const char __user
*data
,
136 size_t count
, loff_t
*off
);
138 static const struct file_operations diag_file_ops
= {
139 .owner
= THIS_MODULE
,
140 .write
= qib_diag_write
,
141 .read
= qib_diag_read
,
142 .open
= qib_diag_open
,
143 .release
= qib_diag_release
,
144 .llseek
= default_llseek
,
147 static atomic_t diagpkt_count
= ATOMIC_INIT(0);
148 static struct cdev
*diagpkt_cdev
;
149 static struct device
*diagpkt_device
;
151 static ssize_t
qib_diagpkt_write(struct file
*fp
, const char __user
*data
,
152 size_t count
, loff_t
*off
);
154 static const struct file_operations diagpkt_file_ops
= {
155 .owner
= THIS_MODULE
,
156 .write
= qib_diagpkt_write
,
157 .llseek
= noop_llseek
,
160 int qib_diag_add(struct qib_devdata
*dd
)
165 if (atomic_inc_return(&diagpkt_count
) == 1) {
166 ret
= qib_cdev_init(QIB_DIAGPKT_MINOR
, "ipath_diagpkt",
167 &diagpkt_file_ops
, &diagpkt_cdev
,
173 snprintf(name
, sizeof(name
), "ipath_diag%d", dd
->unit
);
174 ret
= qib_cdev_init(QIB_DIAG_MINOR_BASE
+ dd
->unit
, name
,
175 &diag_file_ops
, &dd
->diag_cdev
,
181 static void qib_unregister_observers(struct qib_devdata
*dd
);
183 void qib_diag_remove(struct qib_devdata
*dd
)
185 struct qib_diag_client
*dc
;
187 if (atomic_dec_and_test(&diagpkt_count
))
188 qib_cdev_cleanup(&diagpkt_cdev
, &diagpkt_device
);
190 qib_cdev_cleanup(&dd
->diag_cdev
, &dd
->diag_device
);
193 * Return all diag_clients of this device. There should be none,
194 * as we are "guaranteed" that no clients are still open
196 while (dd
->diag_client
)
197 return_client(dd
->diag_client
);
199 /* Now clean up all unused client structs */
200 while (client_pool
) {
202 client_pool
= dc
->next
;
205 /* Clean up observer list */
206 qib_unregister_observers(dd
);
209 /* qib_remap_ioaddr32 - remap an offset into chip address space to __iomem *
211 * @dd: the qlogic_ib device
212 * @offs: the offset in chip-space
213 * @cntp: Pointer to max (byte) count for transfer starting at offset
214 * This returns a u32 __iomem * so it can be used for both 64 and 32-bit
215 * mapping. It is needed because with the use of PAT for control of
216 * write-combining, the logically contiguous address-space of the chip
217 * may be split into virtually non-contiguous spaces, with different
218 * attributes, which are them mapped to contiguous physical space
219 * based from the first BAR.
221 * The code below makes the same assumptions as were made in
222 * init_chip_wc_pat() (qib_init.c), copied here:
223 * Assumes chip address space looks like:
224 * - kregs + sregs + cregs + uregs (in any order)
225 * - piobufs (2K and 4K bufs in either order)
227 * - kregs + sregs + cregs (in any order)
228 * - piobufs (2K and 4K bufs in either order)
231 * If cntp is non-NULL, returns how many bytes from offset can be accessed
232 * Returns 0 if the offset is not mapped.
234 static u32 __iomem
*qib_remap_ioaddr32(struct qib_devdata
*dd
, u32 offset
,
238 u32 snd_bottom
, snd_lim
= 0;
239 u32 __iomem
*krb32
= (u32 __iomem
*)dd
->kregbase
;
240 u32 __iomem
*map
= NULL
;
244 /* First, simplest case, offset is within the first map. */
245 kreglen
= (dd
->kregend
- dd
->kregbase
) * sizeof(u64
);
246 if (offset
< kreglen
) {
247 map
= krb32
+ (offset
/ sizeof(u32
));
248 cnt
= kreglen
- offset
;
253 * Next check for user regs, the next most common case,
254 * and a cheap check because if they are not in the first map
255 * they are last in chip.
258 /* If user regs mapped, they are after send, so set limit. */
259 u32 ulim
= (dd
->cfgctxts
* dd
->ureg_align
) + dd
->uregbase
;
261 if (!dd
->piovl15base
)
262 snd_lim
= dd
->uregbase
;
263 krb32
= (u32 __iomem
*)dd
->userbase
;
264 if (offset
>= dd
->uregbase
&& offset
< ulim
) {
265 map
= krb32
+ (offset
- dd
->uregbase
) / sizeof(u32
);
272 * Lastly, check for offset within Send Buffers.
273 * This is gnarly because struct devdata is deliberately vague
274 * about things like 7322 VL15 buffers, and we are not in
275 * chip-specific code here, so should not make many assumptions.
276 * The one we _do_ make is that the only chip that has more sndbufs
277 * than we admit is the 7322, and it has userregs above that, so
278 * we know the snd_lim.
280 /* Assume 2K buffers are first. */
281 snd_bottom
= dd
->pio2k_bufbase
;
283 u32 tot2k
= dd
->piobcnt2k
* ALIGN(dd
->piosize2k
, dd
->palign
);
285 snd_lim
= snd_bottom
+ tot2k
;
287 /* If 4k buffers exist, account for them by bumping
290 tot4k
= dd
->piobcnt4k
* dd
->align4k
;
291 offs4k
= dd
->piobufbase
>> 32;
293 if (snd_bottom
> offs4k
)
296 /* 4k above 2k. Bump snd_lim, if needed*/
297 if (!dd
->userbase
|| dd
->piovl15base
)
298 snd_lim
= offs4k
+ tot4k
;
302 * Judgement call: can we ignore the space between SendBuffs and
303 * UserRegs, where we would like to see vl15 buffs, but not more?
305 if (offset
>= snd_bottom
&& offset
< snd_lim
) {
306 offset
-= snd_bottom
;
307 map
= (u32 __iomem
*)dd
->piobase
+ (offset
/ sizeof(u32
));
308 cnt
= snd_lim
- offset
;
311 if (!map
&& offs4k
&& dd
->piovl15base
) {
312 snd_lim
= offs4k
+ tot4k
+ 2 * dd
->align4k
;
313 if (offset
>= (offs4k
+ tot4k
) && offset
< snd_lim
) {
314 map
= (u32 __iomem
*)dd
->piovl15base
+
315 ((offset
- (offs4k
+ tot4k
)) / sizeof(u32
));
316 cnt
= snd_lim
- offset
;
327 * qib_read_umem64 - read a 64-bit quantity from the chip into user space
328 * @dd: the qlogic_ib device
329 * @uaddr: the location to store the data in user memory
330 * @regoffs: the offset from BAR0 (_NOT_ full pointer, anymore)
331 * @count: number of bytes to copy (multiple of 32 bits)
333 * This function also localizes all chip memory accesses.
334 * The copy should be written such that we read full cacheline packets
335 * from the chip. This is usually used for a single qword
337 * NOTE: This assumes the chip address is 64-bit aligned.
339 static int qib_read_umem64(struct qib_devdata
*dd
, void __user
*uaddr
,
340 u32 regoffs
, size_t count
)
342 const u64 __iomem
*reg_addr
;
343 const u64 __iomem
*reg_end
;
347 reg_addr
= (const u64 __iomem
*)qib_remap_ioaddr32(dd
, regoffs
, &limit
);
348 if (reg_addr
== NULL
|| limit
== 0 || !(dd
->flags
& QIB_PRESENT
)) {
354 reg_end
= reg_addr
+ (count
/ sizeof(u64
));
356 /* not very efficient, but it works for now */
357 while (reg_addr
< reg_end
) {
358 u64 data
= readq(reg_addr
);
360 if (copy_to_user(uaddr
, &data
, sizeof(u64
))) {
365 uaddr
+= sizeof(u64
);
373 * qib_write_umem64 - write a 64-bit quantity to the chip from user space
374 * @dd: the qlogic_ib device
375 * @regoffs: the offset from BAR0 (_NOT_ full pointer, anymore)
376 * @uaddr: the source of the data in user memory
377 * @count: the number of bytes to copy (multiple of 32 bits)
379 * This is usually used for a single qword
380 * NOTE: This assumes the chip address is 64-bit aligned.
383 static int qib_write_umem64(struct qib_devdata
*dd
, u32 regoffs
,
384 const void __user
*uaddr
, size_t count
)
386 u64 __iomem
*reg_addr
;
387 const u64 __iomem
*reg_end
;
391 reg_addr
= (u64 __iomem
*)qib_remap_ioaddr32(dd
, regoffs
, &limit
);
392 if (reg_addr
== NULL
|| limit
== 0 || !(dd
->flags
& QIB_PRESENT
)) {
398 reg_end
= reg_addr
+ (count
/ sizeof(u64
));
400 /* not very efficient, but it works for now */
401 while (reg_addr
< reg_end
) {
404 if (copy_from_user(&data
, uaddr
, sizeof(data
))) {
408 writeq(data
, reg_addr
);
411 uaddr
+= sizeof(u64
);
419 * qib_read_umem32 - read a 32-bit quantity from the chip into user space
420 * @dd: the qlogic_ib device
421 * @uaddr: the location to store the data in user memory
422 * @regoffs: the offset from BAR0 (_NOT_ full pointer, anymore)
423 * @count: number of bytes to copy
425 * read 32 bit values, not 64 bit; for memories that only
426 * support 32 bit reads; usually a single dword.
428 static int qib_read_umem32(struct qib_devdata
*dd
, void __user
*uaddr
,
429 u32 regoffs
, size_t count
)
431 const u32 __iomem
*reg_addr
;
432 const u32 __iomem
*reg_end
;
436 reg_addr
= qib_remap_ioaddr32(dd
, regoffs
, &limit
);
437 if (reg_addr
== NULL
|| limit
== 0 || !(dd
->flags
& QIB_PRESENT
)) {
443 reg_end
= reg_addr
+ (count
/ sizeof(u32
));
445 /* not very efficient, but it works for now */
446 while (reg_addr
< reg_end
) {
447 u32 data
= readl(reg_addr
);
449 if (copy_to_user(uaddr
, &data
, sizeof(data
))) {
455 uaddr
+= sizeof(u32
);
464 * qib_write_umem32 - write a 32-bit quantity to the chip from user space
465 * @dd: the qlogic_ib device
466 * @regoffs: the offset from BAR0 (_NOT_ full pointer, anymore)
467 * @uaddr: the source of the data in user memory
468 * @count: number of bytes to copy
470 * write 32 bit values, not 64 bit; for memories that only
471 * support 32 bit write; usually a single dword.
474 static int qib_write_umem32(struct qib_devdata
*dd
, u32 regoffs
,
475 const void __user
*uaddr
, size_t count
)
477 u32 __iomem
*reg_addr
;
478 const u32 __iomem
*reg_end
;
482 reg_addr
= qib_remap_ioaddr32(dd
, regoffs
, &limit
);
483 if (reg_addr
== NULL
|| limit
== 0 || !(dd
->flags
& QIB_PRESENT
)) {
489 reg_end
= reg_addr
+ (count
/ sizeof(u32
));
491 while (reg_addr
< reg_end
) {
494 if (copy_from_user(&data
, uaddr
, sizeof(data
))) {
498 writel(data
, reg_addr
);
501 uaddr
+= sizeof(u32
);
508 static int qib_diag_open(struct inode
*in
, struct file
*fp
)
510 int unit
= iminor(in
) - QIB_DIAG_MINOR_BASE
;
511 struct qib_devdata
*dd
;
512 struct qib_diag_client
*dc
;
515 mutex_lock(&qib_mutex
);
517 dd
= qib_lookup(unit
);
519 if (dd
== NULL
|| !(dd
->flags
& QIB_PRESENT
) ||
530 dc
->next
= dd
->diag_client
;
531 dd
->diag_client
= dc
;
532 fp
->private_data
= dc
;
535 mutex_unlock(&qib_mutex
);
541 * qib_diagpkt_write - write an IB packet
542 * @fp: the diag data device file pointer
543 * @data: qib_diag_pkt structure saying where to get the packet
544 * @count: size of data to write
545 * @off: unused by this code
547 static ssize_t
qib_diagpkt_write(struct file
*fp
,
548 const char __user
*data
,
549 size_t count
, loff_t
*off
)
552 u32 plen
, pbufn
, maxlen_reserve
;
553 struct qib_diag_xpkt dp
;
555 struct qib_devdata
*dd
;
556 struct qib_pportdata
*ppd
;
559 if (count
!= sizeof(dp
)) {
563 if (copy_from_user(&dp
, data
, sizeof(dp
))) {
568 dd
= qib_lookup(dp
.unit
);
569 if (!dd
|| !(dd
->flags
& QIB_PRESENT
) || !dd
->kregbase
) {
573 if (!(dd
->flags
& QIB_INITTED
)) {
574 /* no hardware, freeze, etc. */
579 if (dp
.version
!= _DIAG_XPKT_VERS
) {
580 qib_dev_err(dd
, "Invalid version %u for diagpkt_write\n",
585 /* send count must be an exact number of dwords */
590 if (!dp
.port
|| dp
.port
> dd
->num_pports
) {
594 ppd
= &dd
->pport
[dp
.port
- 1];
597 * need total length before first word written, plus 2 Dwords. One Dword
598 * is for padding so we get the full user data when not aligned on
599 * a word boundary. The other Dword is to make sure we have room for the
600 * ICRC which gets tacked on later.
602 maxlen_reserve
= 2 * sizeof(u32
);
603 if (dp
.len
> ppd
->ibmaxlen
- maxlen_reserve
) {
608 plen
= sizeof(u32
) + dp
.len
;
610 tmpbuf
= vmalloc(plen
);
616 if (copy_from_user(tmpbuf
,
617 (const void __user
*) (unsigned long) dp
.data
,
623 plen
>>= 2; /* in dwords */
628 piobuf
= dd
->f_getsendbuf(ppd
, dp
.pbc_wd
, &pbufn
);
633 /* disarm it just to be extra sure */
634 dd
->f_sendctrl(dd
->pport
, QIB_SENDCTRL_DISARM_BUF(pbufn
));
636 /* disable header check on pbufn for this packet */
637 dd
->f_txchk_change(dd
, pbufn
, 1, TXCHK_CHG_TYPE_DIS1
, NULL
);
639 writeq(dp
.pbc_wd
, piobuf
);
641 * Copy all but the trigger word, then flush, so it's written
642 * to chip before trigger word, then write trigger word, then
643 * flush again, so packet is sent.
645 if (dd
->flags
& QIB_PIO_FLUSH_WC
) {
647 qib_pio_copy(piobuf
+ 2, tmpbuf
, plen
- 1);
649 __raw_writel(tmpbuf
[plen
- 1], piobuf
+ plen
+ 1);
651 qib_pio_copy(piobuf
+ 2, tmpbuf
, plen
);
653 if (dd
->flags
& QIB_USE_SPCL_TRIG
) {
654 u32 spcl_off
= (pbufn
>= dd
->piobcnt2k
) ? 2047 : 1023;
657 __raw_writel(0xaebecede, piobuf
+ spcl_off
);
661 * Ensure buffer is written to the chip, then re-enable
662 * header checks (if supported by chip). The txchk
663 * code will ensure seen by chip before returning.
666 qib_sendbuf_done(dd
, pbufn
);
667 dd
->f_txchk_change(dd
, pbufn
, 1, TXCHK_CHG_TYPE_ENAB1
, NULL
);
676 static int qib_diag_release(struct inode
*in
, struct file
*fp
)
678 mutex_lock(&qib_mutex
);
679 return_client(fp
->private_data
);
680 fp
->private_data
= NULL
;
681 mutex_unlock(&qib_mutex
);
686 * Chip-specific code calls to register its interest in
689 struct diag_observer_list_elt
{
690 struct diag_observer_list_elt
*next
;
691 const struct diag_observer
*op
;
694 int qib_register_observer(struct qib_devdata
*dd
,
695 const struct diag_observer
*op
)
697 struct diag_observer_list_elt
*olp
;
702 olp
= vmalloc(sizeof(*olp
));
706 spin_lock_irqsave(&dd
->qib_diag_trans_lock
, flags
);
708 olp
->next
= dd
->diag_observer_list
;
709 dd
->diag_observer_list
= olp
;
710 spin_unlock_irqrestore(&dd
->qib_diag_trans_lock
, flags
);
715 /* Remove all registered observers when device is closed */
716 static void qib_unregister_observers(struct qib_devdata
*dd
)
718 struct diag_observer_list_elt
*olp
;
721 spin_lock_irqsave(&dd
->qib_diag_trans_lock
, flags
);
722 olp
= dd
->diag_observer_list
;
724 /* Pop one observer, let go of lock */
725 dd
->diag_observer_list
= olp
->next
;
726 spin_unlock_irqrestore(&dd
->qib_diag_trans_lock
, flags
);
729 spin_lock_irqsave(&dd
->qib_diag_trans_lock
, flags
);
730 olp
= dd
->diag_observer_list
;
732 spin_unlock_irqrestore(&dd
->qib_diag_trans_lock
, flags
);
736 * Find the observer, if any, for the specified address. Initial implementation
737 * is simple stack of observers. This must be called with diag transaction
740 static const struct diag_observer
*diag_get_observer(struct qib_devdata
*dd
,
743 struct diag_observer_list_elt
*olp
;
744 const struct diag_observer
*op
= NULL
;
746 olp
= dd
->diag_observer_list
;
749 if (addr
>= op
->bottom
&& addr
<= op
->top
)
759 static ssize_t
qib_diag_read(struct file
*fp
, char __user
*data
,
760 size_t count
, loff_t
*off
)
762 struct qib_diag_client
*dc
= fp
->private_data
;
763 struct qib_devdata
*dd
= dc
->dd
;
766 if (dc
->pid
!= current
->pid
) {
773 else if ((count
% 4) || (*off
% 4))
774 /* address or length is not 32-bit aligned, hence invalid */
776 else if (dc
->state
< READY
&& (*off
|| count
!= 8))
777 ret
= -EINVAL
; /* prevent cat /dev/qib_diag* */
782 const struct diag_observer
*op
;
784 use_32
= (count
% 8) || (*off
% 8);
786 spin_lock_irqsave(&dd
->qib_diag_trans_lock
, flags
);
788 * Check for observer on this address range.
789 * we only support a single 32 or 64-bit read
790 * via observer, currently.
792 op
= diag_get_observer(dd
, *off
);
796 ret
= op
->hook(dd
, op
, offset
, &data64
, 0, use_32
);
799 * We need to release lock before any copy_to_user(),
800 * whether implicit in qib_read_umem* or explicit below.
802 spin_unlock_irqrestore(&dd
->qib_diag_trans_lock
, flags
);
806 * Address or length is not 64-bit aligned;
809 ret
= qib_read_umem32(dd
, data
, (u32
) *off
,
812 ret
= qib_read_umem64(dd
, data
, (u32
) *off
,
814 } else if (ret
== count
) {
815 /* Below finishes case where observer existed */
816 ret
= copy_to_user(data
, &data64
, use_32
?
817 sizeof(u32
) : sizeof(u64
));
826 if (dc
->state
== OPENED
)
833 static ssize_t
qib_diag_write(struct file
*fp
, const char __user
*data
,
834 size_t count
, loff_t
*off
)
836 struct qib_diag_client
*dc
= fp
->private_data
;
837 struct qib_devdata
*dd
= dc
->dd
;
840 if (dc
->pid
!= current
->pid
) {
847 else if ((count
% 4) || (*off
% 4))
848 /* address or length is not 32-bit aligned, hence invalid */
850 else if (dc
->state
< READY
&&
851 ((*off
|| count
!= 8) || dc
->state
!= INIT
))
852 /* No writes except second-step of init seq */
853 ret
= -EINVAL
; /* before any other write allowed */
856 const struct diag_observer
*op
= NULL
;
857 int use_32
= (count
% 8) || (*off
% 8);
860 * Check for observer on this address range.
861 * We only support a single 32 or 64-bit write
862 * via observer, currently. This helps, because
863 * we would otherwise have to jump through hoops
864 * to make "diag transaction" meaningful when we
865 * cannot do a copy_from_user while holding the lock.
867 if (count
== 4 || count
== 8) {
871 ret
= copy_from_user(&data64
, data
, count
);
876 spin_lock_irqsave(&dd
->qib_diag_trans_lock
, flags
);
877 op
= diag_get_observer(dd
, *off
);
879 ret
= op
->hook(dd
, op
, offset
, &data64
, ~0Ull,
881 spin_unlock_irqrestore(&dd
->qib_diag_trans_lock
, flags
);
887 * Address or length is not 64-bit aligned;
890 ret
= qib_write_umem32(dd
, (u32
) *off
, data
,
893 ret
= qib_write_umem64(dd
, (u32
) *off
, data
,
901 if (dc
->state
== INIT
)
902 dc
->state
= READY
; /* all read/write OK now */