5 #include <linux/types.h>
6 #include <linux/errno.h>
8 #include <linux/tty_driver.h>
9 #include <linux/tty_flip.h>
10 #include <linux/serial.h>
11 #include <linux/timer.h>
12 #include <linux/string.h>
13 #include <linux/slab.h>
14 #include <linux/sched.h>
15 #include <linux/wait.h>
16 #include <linux/bitops.h>
17 #include <linux/delay.h>
18 #include <linux/module.h>
20 void tty_port_init(struct tty_port
*port
)
22 memset(port
, 0, sizeof(*port
));
23 tty_buffer_init(port
);
24 init_waitqueue_head(&port
->open_wait
);
25 init_waitqueue_head(&port
->delta_msr_wait
);
26 mutex_init(&port
->mutex
);
27 mutex_init(&port
->buf_mutex
);
28 spin_lock_init(&port
->lock
);
29 port
->close_delay
= (50 * HZ
) / 100;
30 port
->closing_wait
= (3000 * HZ
) / 100;
31 kref_init(&port
->kref
);
33 EXPORT_SYMBOL(tty_port_init
);
36 * tty_port_link_device - link tty and tty_port
37 * @port: tty_port of the device
38 * @driver: tty_driver for this device
39 * @index: index of the tty
41 * Provide the tty layer wit ha link from a tty (specified by @index) to a
42 * tty_port (@port). Use this only if neither tty_port_register_device nor
43 * tty_port_install is used in the driver. If used, this has to be called before
44 * tty_register_driver.
46 void tty_port_link_device(struct tty_port
*port
,
47 struct tty_driver
*driver
, unsigned index
)
49 if (WARN_ON(index
>= driver
->num
))
51 driver
->ports
[index
] = port
;
53 EXPORT_SYMBOL_GPL(tty_port_link_device
);
56 * tty_port_register_device - register tty device
57 * @port: tty_port of the device
58 * @driver: tty_driver for this device
59 * @index: index of the tty
60 * @device: parent if exists, otherwise NULL
62 * It is the same as tty_register_device except the provided @port is linked to
63 * a concrete tty specified by @index. Use this or tty_port_install (or both).
64 * Call tty_port_link_device as a last resort.
66 struct device
*tty_port_register_device(struct tty_port
*port
,
67 struct tty_driver
*driver
, unsigned index
,
68 struct device
*device
)
70 tty_port_link_device(port
, driver
, index
);
71 return tty_register_device(driver
, index
, device
);
73 EXPORT_SYMBOL_GPL(tty_port_register_device
);
76 * tty_port_register_device_attr - register tty device
77 * @port: tty_port of the device
78 * @driver: tty_driver for this device
79 * @index: index of the tty
80 * @device: parent if exists, otherwise NULL
81 * @drvdata: Driver data to be set to device.
82 * @attr_grp: Attribute group to be set on device.
84 * It is the same as tty_register_device_attr except the provided @port is
85 * linked to a concrete tty specified by @index. Use this or tty_port_install
86 * (or both). Call tty_port_link_device as a last resort.
88 struct device
*tty_port_register_device_attr(struct tty_port
*port
,
89 struct tty_driver
*driver
, unsigned index
,
90 struct device
*device
, void *drvdata
,
91 const struct attribute_group
**attr_grp
)
93 tty_port_link_device(port
, driver
, index
);
94 return tty_register_device_attr(driver
, index
, device
, drvdata
,
97 EXPORT_SYMBOL_GPL(tty_port_register_device_attr
);
99 int tty_port_alloc_xmit_buf(struct tty_port
*port
)
101 /* We may sleep in get_zeroed_page() */
102 mutex_lock(&port
->buf_mutex
);
103 if (port
->xmit_buf
== NULL
)
104 port
->xmit_buf
= (unsigned char *)get_zeroed_page(GFP_KERNEL
);
105 mutex_unlock(&port
->buf_mutex
);
106 if (port
->xmit_buf
== NULL
)
110 EXPORT_SYMBOL(tty_port_alloc_xmit_buf
);
112 void tty_port_free_xmit_buf(struct tty_port
*port
)
114 mutex_lock(&port
->buf_mutex
);
115 if (port
->xmit_buf
!= NULL
) {
116 free_page((unsigned long)port
->xmit_buf
);
117 port
->xmit_buf
= NULL
;
119 mutex_unlock(&port
->buf_mutex
);
121 EXPORT_SYMBOL(tty_port_free_xmit_buf
);
124 * tty_port_destroy -- destroy inited port
125 * @port: tty port to be doestroyed
127 * When a port was initialized using tty_port_init, one has to destroy the
128 * port by this function. Either indirectly by using tty_port refcounting
129 * (tty_port_put) or directly if refcounting is not used.
131 void tty_port_destroy(struct tty_port
*port
)
133 tty_buffer_cancel_work(port
);
134 tty_buffer_free_all(port
);
136 EXPORT_SYMBOL(tty_port_destroy
);
138 static void tty_port_destructor(struct kref
*kref
)
140 struct tty_port
*port
= container_of(kref
, struct tty_port
, kref
);
142 /* check if last port ref was dropped before tty release */
143 if (WARN_ON(port
->itty
))
146 free_page((unsigned long)port
->xmit_buf
);
147 tty_port_destroy(port
);
148 if (port
->ops
&& port
->ops
->destruct
)
149 port
->ops
->destruct(port
);
154 void tty_port_put(struct tty_port
*port
)
157 kref_put(&port
->kref
, tty_port_destructor
);
159 EXPORT_SYMBOL(tty_port_put
);
162 * tty_port_tty_get - get a tty reference
165 * Return a refcount protected tty instance or NULL if the port is not
166 * associated with a tty (eg due to close or hangup)
169 struct tty_struct
*tty_port_tty_get(struct tty_port
*port
)
172 struct tty_struct
*tty
;
174 spin_lock_irqsave(&port
->lock
, flags
);
175 tty
= tty_kref_get(port
->tty
);
176 spin_unlock_irqrestore(&port
->lock
, flags
);
179 EXPORT_SYMBOL(tty_port_tty_get
);
182 * tty_port_tty_set - set the tty of a port
186 * Associate the port and tty pair. Manages any internal refcounts.
187 * Pass NULL to deassociate a port
190 void tty_port_tty_set(struct tty_port
*port
, struct tty_struct
*tty
)
194 spin_lock_irqsave(&port
->lock
, flags
);
195 tty_kref_put(port
->tty
);
196 port
->tty
= tty_kref_get(tty
);
197 spin_unlock_irqrestore(&port
->lock
, flags
);
199 EXPORT_SYMBOL(tty_port_tty_set
);
201 static void tty_port_shutdown(struct tty_port
*port
, struct tty_struct
*tty
)
203 mutex_lock(&port
->mutex
);
207 if (test_and_clear_bit(ASYNCB_INITIALIZED
, &port
->flags
)) {
209 * Drop DTR/RTS if HUPCL is set. This causes any attached
210 * modem to hang up the line.
212 if (tty
&& C_HUPCL(tty
))
213 tty_port_lower_dtr_rts(port
);
215 if (port
->ops
->shutdown
)
216 port
->ops
->shutdown(port
);
219 mutex_unlock(&port
->mutex
);
223 * tty_port_hangup - hangup helper
226 * Perform port level tty hangup flag and count changes. Drop the tty
229 * Caller holds tty lock.
232 void tty_port_hangup(struct tty_port
*port
)
234 struct tty_struct
*tty
;
237 spin_lock_irqsave(&port
->lock
, flags
);
239 port
->flags
&= ~ASYNC_NORMAL_ACTIVE
;
242 set_bit(TTY_IO_ERROR
, &tty
->flags
);
244 spin_unlock_irqrestore(&port
->lock
, flags
);
245 tty_port_shutdown(port
, tty
);
247 wake_up_interruptible(&port
->open_wait
);
248 wake_up_interruptible(&port
->delta_msr_wait
);
250 EXPORT_SYMBOL(tty_port_hangup
);
253 * tty_port_tty_hangup - helper to hang up a tty
256 * @check_clocal: hang only ttys with CLOCAL unset?
258 void tty_port_tty_hangup(struct tty_port
*port
, bool check_clocal
)
260 struct tty_struct
*tty
= tty_port_tty_get(port
);
262 if (tty
&& (!check_clocal
|| !C_CLOCAL(tty
)))
266 EXPORT_SYMBOL_GPL(tty_port_tty_hangup
);
269 * tty_port_tty_wakeup - helper to wake up a tty
273 void tty_port_tty_wakeup(struct tty_port
*port
)
275 struct tty_struct
*tty
= tty_port_tty_get(port
);
282 EXPORT_SYMBOL_GPL(tty_port_tty_wakeup
);
285 * tty_port_carrier_raised - carrier raised check
288 * Wrapper for the carrier detect logic. For the moment this is used
289 * to hide some internal details. This will eventually become entirely
290 * internal to the tty port.
293 int tty_port_carrier_raised(struct tty_port
*port
)
295 if (port
->ops
->carrier_raised
== NULL
)
297 return port
->ops
->carrier_raised(port
);
299 EXPORT_SYMBOL(tty_port_carrier_raised
);
302 * tty_port_raise_dtr_rts - Raise DTR/RTS
305 * Wrapper for the DTR/RTS raise logic. For the moment this is used
306 * to hide some internal details. This will eventually become entirely
307 * internal to the tty port.
310 void tty_port_raise_dtr_rts(struct tty_port
*port
)
312 if (port
->ops
->dtr_rts
)
313 port
->ops
->dtr_rts(port
, 1);
315 EXPORT_SYMBOL(tty_port_raise_dtr_rts
);
318 * tty_port_lower_dtr_rts - Lower DTR/RTS
321 * Wrapper for the DTR/RTS raise logic. For the moment this is used
322 * to hide some internal details. This will eventually become entirely
323 * internal to the tty port.
326 void tty_port_lower_dtr_rts(struct tty_port
*port
)
328 if (port
->ops
->dtr_rts
)
329 port
->ops
->dtr_rts(port
, 0);
331 EXPORT_SYMBOL(tty_port_lower_dtr_rts
);
334 * tty_port_block_til_ready - Waiting logic for tty open
335 * @port: the tty port being opened
336 * @tty: the tty device being bound
337 * @filp: the file pointer of the opener
339 * Implement the core POSIX/SuS tty behaviour when opening a tty device.
341 * - hangup (both before and during)
342 * - non blocking open
345 * - port flags and counts
347 * The passed tty_port must implement the carrier_raised method if it can
348 * do carrier detect and the dtr_rts method if it supports software
349 * management of these lines. Note that the dtr/rts raise is done each
350 * iteration as a hangup may have previously dropped them while we wait.
352 * Caller holds tty lock.
354 * NB: May drop and reacquire tty lock when blocking, so tty and tty_port
355 * may have changed state (eg., may have been hung up).
358 int tty_port_block_til_ready(struct tty_port
*port
,
359 struct tty_struct
*tty
, struct file
*filp
)
361 int do_clocal
= 0, retval
;
365 /* if non-blocking mode is set we can pass directly to open unless
366 the port has just hung up or is in another error state */
367 if (tty
->flags
& (1 << TTY_IO_ERROR
)) {
368 port
->flags
|= ASYNC_NORMAL_ACTIVE
;
371 if (filp
->f_flags
& O_NONBLOCK
) {
372 /* Indicate we are open */
373 if (tty
->termios
.c_cflag
& CBAUD
)
374 tty_port_raise_dtr_rts(port
);
375 port
->flags
|= ASYNC_NORMAL_ACTIVE
;
382 /* Block waiting until we can proceed. We may need to wait for the
383 carrier, but we must also wait for any close that is in progress
384 before the next open may complete */
388 /* The port lock protects the port counts */
389 spin_lock_irqsave(&port
->lock
, flags
);
391 port
->blocked_open
++;
392 spin_unlock_irqrestore(&port
->lock
, flags
);
395 /* Indicate we are open */
396 if (C_BAUD(tty
) && test_bit(ASYNCB_INITIALIZED
, &port
->flags
))
397 tty_port_raise_dtr_rts(port
);
399 prepare_to_wait(&port
->open_wait
, &wait
, TASK_INTERRUPTIBLE
);
400 /* Check for a hangup or uninitialised port.
401 Return accordingly */
402 if (tty_hung_up_p(filp
) || !(port
->flags
& ASYNC_INITIALIZED
)) {
403 if (port
->flags
& ASYNC_HUP_NOTIFY
)
406 retval
= -ERESTARTSYS
;
410 * Probe the carrier. For devices with no carrier detect
411 * tty_port_carrier_raised will always return true.
412 * Never ask drivers if CLOCAL is set, this causes troubles
415 if (do_clocal
|| tty_port_carrier_raised(port
))
417 if (signal_pending(current
)) {
418 retval
= -ERESTARTSYS
;
425 finish_wait(&port
->open_wait
, &wait
);
427 /* Update counts. A parallel hangup will have set count to zero and
428 we must not mess that up further */
429 spin_lock_irqsave(&port
->lock
, flags
);
430 if (!tty_hung_up_p(filp
))
432 port
->blocked_open
--;
434 port
->flags
|= ASYNC_NORMAL_ACTIVE
;
435 spin_unlock_irqrestore(&port
->lock
, flags
);
438 EXPORT_SYMBOL(tty_port_block_til_ready
);
440 static void tty_port_drain_delay(struct tty_port
*port
, struct tty_struct
*tty
)
442 unsigned int bps
= tty_get_baud_rate(tty
);
446 timeout
= (HZ
* 10 * port
->drain_delay
) / bps
;
447 timeout
= max_t(long, timeout
, HZ
/ 10);
451 schedule_timeout_interruptible(timeout
);
454 /* Caller holds tty lock. */
455 int tty_port_close_start(struct tty_port
*port
,
456 struct tty_struct
*tty
, struct file
*filp
)
460 if (tty_hung_up_p(filp
))
463 spin_lock_irqsave(&port
->lock
, flags
);
464 if (tty
->count
== 1 && port
->count
!= 1) {
466 "tty_port_close_start: tty->count = 1 port count = %d.\n",
470 if (--port
->count
< 0) {
471 printk(KERN_WARNING
"tty_port_close_start: count = %d\n",
477 spin_unlock_irqrestore(&port
->lock
, flags
);
480 set_bit(ASYNCB_CLOSING
, &port
->flags
);
481 spin_unlock_irqrestore(&port
->lock
, flags
);
485 if (test_bit(ASYNCB_INITIALIZED
, &port
->flags
)) {
486 /* Don't block on a stalled port, just pull the chain */
487 if (tty
->flow_stopped
)
488 tty_driver_flush_buffer(tty
);
489 if (port
->closing_wait
!= ASYNC_CLOSING_WAIT_NONE
)
490 tty_wait_until_sent(tty
, port
->closing_wait
);
491 if (port
->drain_delay
)
492 tty_port_drain_delay(port
, tty
);
494 /* Flush the ldisc buffering */
495 tty_ldisc_flush(tty
);
497 /* Report to caller this is the last port reference */
500 EXPORT_SYMBOL(tty_port_close_start
);
502 /* Caller holds tty lock */
503 void tty_port_close_end(struct tty_port
*port
, struct tty_struct
*tty
)
507 tty_ldisc_flush(tty
);
510 spin_lock_irqsave(&port
->lock
, flags
);
512 if (port
->blocked_open
) {
513 spin_unlock_irqrestore(&port
->lock
, flags
);
514 if (port
->close_delay
) {
515 msleep_interruptible(
516 jiffies_to_msecs(port
->close_delay
));
518 spin_lock_irqsave(&port
->lock
, flags
);
519 wake_up_interruptible(&port
->open_wait
);
521 port
->flags
&= ~(ASYNC_NORMAL_ACTIVE
| ASYNC_CLOSING
);
522 spin_unlock_irqrestore(&port
->lock
, flags
);
524 EXPORT_SYMBOL(tty_port_close_end
);
529 * Caller holds tty lock
531 void tty_port_close(struct tty_port
*port
, struct tty_struct
*tty
,
534 if (tty_port_close_start(port
, tty
, filp
) == 0)
536 tty_port_shutdown(port
, tty
);
537 set_bit(TTY_IO_ERROR
, &tty
->flags
);
538 tty_port_close_end(port
, tty
);
539 tty_port_tty_set(port
, NULL
);
541 EXPORT_SYMBOL(tty_port_close
);
544 * tty_port_install - generic tty->ops->install handler
545 * @port: tty_port of the device
546 * @driver: tty_driver for this device
547 * @tty: tty to be installed
549 * It is the same as tty_standard_install except the provided @port is linked
550 * to a concrete tty specified by @tty. Use this or tty_port_register_device
551 * (or both). Call tty_port_link_device as a last resort.
553 int tty_port_install(struct tty_port
*port
, struct tty_driver
*driver
,
554 struct tty_struct
*tty
)
557 return tty_standard_install(driver
, tty
);
559 EXPORT_SYMBOL_GPL(tty_port_install
);
564 * Caller holds tty lock.
566 * NB: may drop and reacquire tty lock (in tty_port_block_til_ready()) so
567 * tty and tty_port may have changed state (eg., may be hung up now)
569 int tty_port_open(struct tty_port
*port
, struct tty_struct
*tty
,
572 spin_lock_irq(&port
->lock
);
574 spin_unlock_irq(&port
->lock
);
575 tty_port_tty_set(port
, tty
);
578 * Do the device-specific open only if the hardware isn't
579 * already initialized. Serialize open and shutdown using the
583 mutex_lock(&port
->mutex
);
585 if (!test_bit(ASYNCB_INITIALIZED
, &port
->flags
)) {
586 clear_bit(TTY_IO_ERROR
, &tty
->flags
);
587 if (port
->ops
->activate
) {
588 int retval
= port
->ops
->activate(port
, tty
);
590 mutex_unlock(&port
->mutex
);
594 set_bit(ASYNCB_INITIALIZED
, &port
->flags
);
596 mutex_unlock(&port
->mutex
);
597 return tty_port_block_til_ready(port
, tty
, filp
);
600 EXPORT_SYMBOL(tty_port_open
);