treewide: remove redundant IS_ERR() before error code check
[linux/fpc-iii.git] / drivers / s390 / char / sclp_tty.c
blob5aff8b684eb21e8557f253c7ddf18d48420435c1
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * SCLP line mode terminal driver.
5 * S390 version
6 * Copyright IBM Corp. 1999
7 * Author(s): Martin Peschke <mpeschke@de.ibm.com>
8 * Martin Schwidefsky <schwidefsky@de.ibm.com>
9 */
11 #include <linux/kmod.h>
12 #include <linux/tty.h>
13 #include <linux/tty_driver.h>
14 #include <linux/tty_flip.h>
15 #include <linux/err.h>
16 #include <linux/init.h>
17 #include <linux/interrupt.h>
18 #include <linux/gfp.h>
19 #include <linux/uaccess.h>
21 #include "ctrlchar.h"
22 #include "sclp.h"
23 #include "sclp_rw.h"
24 #include "sclp_tty.h"
27 * size of a buffer that collects single characters coming in
28 * via sclp_tty_put_char()
30 #define SCLP_TTY_BUF_SIZE 512
33 * There is exactly one SCLP terminal, so we can keep things simple
34 * and allocate all variables statically.
37 /* Lock to guard over changes to global variables. */
38 static spinlock_t sclp_tty_lock;
39 /* List of free pages that can be used for console output buffering. */
40 static struct list_head sclp_tty_pages;
41 /* List of full struct sclp_buffer structures ready for output. */
42 static struct list_head sclp_tty_outqueue;
43 /* Counter how many buffers are emitted. */
44 static int sclp_tty_buffer_count;
45 /* Pointer to current console buffer. */
46 static struct sclp_buffer *sclp_ttybuf;
47 /* Timer for delayed output of console messages. */
48 static struct timer_list sclp_tty_timer;
50 static struct tty_port sclp_port;
51 static unsigned char sclp_tty_chars[SCLP_TTY_BUF_SIZE];
52 static unsigned short int sclp_tty_chars_count;
54 struct tty_driver *sclp_tty_driver;
56 static int sclp_tty_tolower;
57 static int sclp_tty_columns = 80;
59 #define SPACES_PER_TAB 8
60 #define CASE_DELIMITER 0x6c /* to separate upper and lower case (% in EBCDIC) */
62 /* This routine is called whenever we try to open a SCLP terminal. */
63 static int
64 sclp_tty_open(struct tty_struct *tty, struct file *filp)
66 tty_port_tty_set(&sclp_port, tty);
67 tty->driver_data = NULL;
68 sclp_port.low_latency = 0;
69 return 0;
72 /* This routine is called when the SCLP terminal is closed. */
73 static void
74 sclp_tty_close(struct tty_struct *tty, struct file *filp)
76 if (tty->count > 1)
77 return;
78 tty_port_tty_set(&sclp_port, NULL);
82 * This routine returns the numbers of characters the tty driver
83 * will accept for queuing to be written. This number is subject
84 * to change as output buffers get emptied, or if the output flow
85 * control is acted. This is not an exact number because not every
86 * character needs the same space in the sccb. The worst case is
87 * a string of newlines. Every newline creates a new message which
88 * needs 82 bytes.
90 static int
91 sclp_tty_write_room (struct tty_struct *tty)
93 unsigned long flags;
94 struct list_head *l;
95 int count;
97 spin_lock_irqsave(&sclp_tty_lock, flags);
98 count = 0;
99 if (sclp_ttybuf != NULL)
100 count = sclp_buffer_space(sclp_ttybuf) / sizeof(struct msg_buf);
101 list_for_each(l, &sclp_tty_pages)
102 count += NR_EMPTY_MSG_PER_SCCB;
103 spin_unlock_irqrestore(&sclp_tty_lock, flags);
104 return count;
107 static void
108 sclp_ttybuf_callback(struct sclp_buffer *buffer, int rc)
110 unsigned long flags;
111 void *page;
113 do {
114 page = sclp_unmake_buffer(buffer);
115 spin_lock_irqsave(&sclp_tty_lock, flags);
116 /* Remove buffer from outqueue */
117 list_del(&buffer->list);
118 sclp_tty_buffer_count--;
119 list_add_tail((struct list_head *) page, &sclp_tty_pages);
120 /* Check if there is a pending buffer on the out queue. */
121 buffer = NULL;
122 if (!list_empty(&sclp_tty_outqueue))
123 buffer = list_entry(sclp_tty_outqueue.next,
124 struct sclp_buffer, list);
125 spin_unlock_irqrestore(&sclp_tty_lock, flags);
126 } while (buffer && sclp_emit_buffer(buffer, sclp_ttybuf_callback));
128 tty_port_tty_wakeup(&sclp_port);
131 static inline void
132 __sclp_ttybuf_emit(struct sclp_buffer *buffer)
134 unsigned long flags;
135 int count;
136 int rc;
138 spin_lock_irqsave(&sclp_tty_lock, flags);
139 list_add_tail(&buffer->list, &sclp_tty_outqueue);
140 count = sclp_tty_buffer_count++;
141 spin_unlock_irqrestore(&sclp_tty_lock, flags);
142 if (count)
143 return;
144 rc = sclp_emit_buffer(buffer, sclp_ttybuf_callback);
145 if (rc)
146 sclp_ttybuf_callback(buffer, rc);
150 * When this routine is called from the timer then we flush the
151 * temporary write buffer.
153 static void
154 sclp_tty_timeout(struct timer_list *unused)
156 unsigned long flags;
157 struct sclp_buffer *buf;
159 spin_lock_irqsave(&sclp_tty_lock, flags);
160 buf = sclp_ttybuf;
161 sclp_ttybuf = NULL;
162 spin_unlock_irqrestore(&sclp_tty_lock, flags);
164 if (buf != NULL) {
165 __sclp_ttybuf_emit(buf);
170 * Write a string to the sclp tty.
172 static int sclp_tty_write_string(const unsigned char *str, int count, int may_fail)
174 unsigned long flags;
175 void *page;
176 int written;
177 int overall_written;
178 struct sclp_buffer *buf;
180 if (count <= 0)
181 return 0;
182 overall_written = 0;
183 spin_lock_irqsave(&sclp_tty_lock, flags);
184 do {
185 /* Create a sclp output buffer if none exists yet */
186 if (sclp_ttybuf == NULL) {
187 while (list_empty(&sclp_tty_pages)) {
188 spin_unlock_irqrestore(&sclp_tty_lock, flags);
189 if (may_fail)
190 goto out;
191 else
192 sclp_sync_wait();
193 spin_lock_irqsave(&sclp_tty_lock, flags);
195 page = sclp_tty_pages.next;
196 list_del((struct list_head *) page);
197 sclp_ttybuf = sclp_make_buffer(page, sclp_tty_columns,
198 SPACES_PER_TAB);
200 /* try to write the string to the current output buffer */
201 written = sclp_write(sclp_ttybuf, str, count);
202 overall_written += written;
203 if (written == count)
204 break;
206 * Not all characters could be written to the current
207 * output buffer. Emit the buffer, create a new buffer
208 * and then output the rest of the string.
210 buf = sclp_ttybuf;
211 sclp_ttybuf = NULL;
212 spin_unlock_irqrestore(&sclp_tty_lock, flags);
213 __sclp_ttybuf_emit(buf);
214 spin_lock_irqsave(&sclp_tty_lock, flags);
215 str += written;
216 count -= written;
217 } while (count > 0);
218 /* Setup timer to output current console buffer after 1/10 second */
219 if (sclp_ttybuf && sclp_chars_in_buffer(sclp_ttybuf) &&
220 !timer_pending(&sclp_tty_timer)) {
221 mod_timer(&sclp_tty_timer, jiffies + HZ / 10);
223 spin_unlock_irqrestore(&sclp_tty_lock, flags);
224 out:
225 return overall_written;
229 * This routine is called by the kernel to write a series of characters to the
230 * tty device. The characters may come from user space or kernel space. This
231 * routine will return the number of characters actually accepted for writing.
233 static int
234 sclp_tty_write(struct tty_struct *tty, const unsigned char *buf, int count)
236 if (sclp_tty_chars_count > 0) {
237 sclp_tty_write_string(sclp_tty_chars, sclp_tty_chars_count, 0);
238 sclp_tty_chars_count = 0;
240 return sclp_tty_write_string(buf, count, 1);
244 * This routine is called by the kernel to write a single character to the tty
245 * device. If the kernel uses this routine, it must call the flush_chars()
246 * routine (if defined) when it is done stuffing characters into the driver.
248 * Characters provided to sclp_tty_put_char() are buffered by the SCLP driver.
249 * If the given character is a '\n' the contents of the SCLP write buffer
250 * - including previous characters from sclp_tty_put_char() and strings from
251 * sclp_write() without final '\n' - will be written.
253 static int
254 sclp_tty_put_char(struct tty_struct *tty, unsigned char ch)
256 sclp_tty_chars[sclp_tty_chars_count++] = ch;
257 if (ch == '\n' || sclp_tty_chars_count >= SCLP_TTY_BUF_SIZE) {
258 sclp_tty_write_string(sclp_tty_chars, sclp_tty_chars_count, 0);
259 sclp_tty_chars_count = 0;
261 return 1;
265 * This routine is called by the kernel after it has written a series of
266 * characters to the tty device using put_char().
268 static void
269 sclp_tty_flush_chars(struct tty_struct *tty)
271 if (sclp_tty_chars_count > 0) {
272 sclp_tty_write_string(sclp_tty_chars, sclp_tty_chars_count, 0);
273 sclp_tty_chars_count = 0;
278 * This routine returns the number of characters in the write buffer of the
279 * SCLP driver. The provided number includes all characters that are stored
280 * in the SCCB (will be written next time the SCLP is not busy) as well as
281 * characters in the write buffer (will not be written as long as there is a
282 * final line feed missing).
284 static int
285 sclp_tty_chars_in_buffer(struct tty_struct *tty)
287 unsigned long flags;
288 struct list_head *l;
289 struct sclp_buffer *t;
290 int count;
292 spin_lock_irqsave(&sclp_tty_lock, flags);
293 count = 0;
294 if (sclp_ttybuf != NULL)
295 count = sclp_chars_in_buffer(sclp_ttybuf);
296 list_for_each(l, &sclp_tty_outqueue) {
297 t = list_entry(l, struct sclp_buffer, list);
298 count += sclp_chars_in_buffer(t);
300 spin_unlock_irqrestore(&sclp_tty_lock, flags);
301 return count;
305 * removes all content from buffers of low level driver
307 static void
308 sclp_tty_flush_buffer(struct tty_struct *tty)
310 if (sclp_tty_chars_count > 0) {
311 sclp_tty_write_string(sclp_tty_chars, sclp_tty_chars_count, 0);
312 sclp_tty_chars_count = 0;
317 * push input to tty
319 static void
320 sclp_tty_input(unsigned char* buf, unsigned int count)
322 struct tty_struct *tty = tty_port_tty_get(&sclp_port);
323 unsigned int cchar;
326 * If this tty driver is currently closed
327 * then throw the received input away.
329 if (tty == NULL)
330 return;
331 cchar = ctrlchar_handle(buf, count, tty);
332 switch (cchar & CTRLCHAR_MASK) {
333 case CTRLCHAR_SYSRQ:
334 break;
335 case CTRLCHAR_CTRL:
336 tty_insert_flip_char(&sclp_port, cchar, TTY_NORMAL);
337 tty_flip_buffer_push(&sclp_port);
338 break;
339 case CTRLCHAR_NONE:
340 /* send (normal) input to line discipline */
341 if (count < 2 ||
342 (strncmp((const char *) buf + count - 2, "^n", 2) &&
343 strncmp((const char *) buf + count - 2, "\252n", 2))) {
344 /* add the auto \n */
345 tty_insert_flip_string(&sclp_port, buf, count);
346 tty_insert_flip_char(&sclp_port, '\n', TTY_NORMAL);
347 } else
348 tty_insert_flip_string(&sclp_port, buf, count - 2);
349 tty_flip_buffer_push(&sclp_port);
350 break;
352 tty_kref_put(tty);
356 * get a EBCDIC string in upper/lower case,
357 * find out characters in lower/upper case separated by a special character,
358 * modifiy original string,
359 * returns length of resulting string
361 static int sclp_switch_cases(unsigned char *buf, int count)
363 unsigned char *ip, *op;
364 int toggle;
366 /* initially changing case is off */
367 toggle = 0;
368 ip = op = buf;
369 while (count-- > 0) {
370 /* compare with special character */
371 if (*ip == CASE_DELIMITER) {
372 /* followed by another special character? */
373 if (count && ip[1] == CASE_DELIMITER) {
375 * ... then put a single copy of the special
376 * character to the output string
378 *op++ = *ip++;
379 count--;
380 } else
382 * ... special character follower by a normal
383 * character toggles the case change behaviour
385 toggle = ~toggle;
386 /* skip special character */
387 ip++;
388 } else
389 /* not the special character */
390 if (toggle)
391 /* but case switching is on */
392 if (sclp_tty_tolower)
393 /* switch to uppercase */
394 *op++ = _ebc_toupper[(int) *ip++];
395 else
396 /* switch to lowercase */
397 *op++ = _ebc_tolower[(int) *ip++];
398 else
399 /* no case switching, copy the character */
400 *op++ = *ip++;
402 /* return length of reformatted string. */
403 return op - buf;
406 static void sclp_get_input(struct gds_subvector *sv)
408 unsigned char *str;
409 int count;
411 str = (unsigned char *) (sv + 1);
412 count = sv->length - sizeof(*sv);
413 if (sclp_tty_tolower)
414 EBC_TOLOWER(str, count);
415 count = sclp_switch_cases(str, count);
416 /* convert EBCDIC to ASCII (modify original input in SCCB) */
417 sclp_ebcasc_str(str, count);
419 /* transfer input to high level driver */
420 sclp_tty_input(str, count);
423 static inline void sclp_eval_selfdeftextmsg(struct gds_subvector *sv)
425 void *end;
427 end = (void *) sv + sv->length;
428 for (sv = sv + 1; (void *) sv < end; sv = (void *) sv + sv->length)
429 if (sv->key == 0x30)
430 sclp_get_input(sv);
433 static inline void sclp_eval_textcmd(struct gds_vector *v)
435 struct gds_subvector *sv;
436 void *end;
438 end = (void *) v + v->length;
439 for (sv = (struct gds_subvector *) (v + 1);
440 (void *) sv < end; sv = (void *) sv + sv->length)
441 if (sv->key == GDS_KEY_SELFDEFTEXTMSG)
442 sclp_eval_selfdeftextmsg(sv);
446 static inline void sclp_eval_cpmsu(struct gds_vector *v)
448 void *end;
450 end = (void *) v + v->length;
451 for (v = v + 1; (void *) v < end; v = (void *) v + v->length)
452 if (v->gds_id == GDS_ID_TEXTCMD)
453 sclp_eval_textcmd(v);
457 static inline void sclp_eval_mdsmu(struct gds_vector *v)
459 v = sclp_find_gds_vector(v + 1, (void *) v + v->length, GDS_ID_CPMSU);
460 if (v)
461 sclp_eval_cpmsu(v);
464 static void sclp_tty_receiver(struct evbuf_header *evbuf)
466 struct gds_vector *v;
468 v = sclp_find_gds_vector(evbuf + 1, (void *) evbuf + evbuf->length,
469 GDS_ID_MDSMU);
470 if (v)
471 sclp_eval_mdsmu(v);
474 static void
475 sclp_tty_state_change(struct sclp_register *reg)
479 static struct sclp_register sclp_input_event =
481 .receive_mask = EVTYP_OPCMD_MASK | EVTYP_PMSGCMD_MASK,
482 .state_change_fn = sclp_tty_state_change,
483 .receiver_fn = sclp_tty_receiver
486 static const struct tty_operations sclp_ops = {
487 .open = sclp_tty_open,
488 .close = sclp_tty_close,
489 .write = sclp_tty_write,
490 .put_char = sclp_tty_put_char,
491 .flush_chars = sclp_tty_flush_chars,
492 .write_room = sclp_tty_write_room,
493 .chars_in_buffer = sclp_tty_chars_in_buffer,
494 .flush_buffer = sclp_tty_flush_buffer,
497 static int __init
498 sclp_tty_init(void)
500 struct tty_driver *driver;
501 void *page;
502 int i;
503 int rc;
505 /* z/VM multiplexes the line mode output on the 32xx screen */
506 if (MACHINE_IS_VM && !CONSOLE_IS_SCLP)
507 return 0;
508 if (!sclp.has_linemode)
509 return 0;
510 driver = alloc_tty_driver(1);
511 if (!driver)
512 return -ENOMEM;
514 rc = sclp_rw_init();
515 if (rc) {
516 put_tty_driver(driver);
517 return rc;
519 /* Allocate pages for output buffering */
520 INIT_LIST_HEAD(&sclp_tty_pages);
521 for (i = 0; i < MAX_KMEM_PAGES; i++) {
522 page = (void *) get_zeroed_page(GFP_KERNEL | GFP_DMA);
523 if (page == NULL) {
524 put_tty_driver(driver);
525 return -ENOMEM;
527 list_add_tail((struct list_head *) page, &sclp_tty_pages);
529 INIT_LIST_HEAD(&sclp_tty_outqueue);
530 spin_lock_init(&sclp_tty_lock);
531 timer_setup(&sclp_tty_timer, sclp_tty_timeout, 0);
532 sclp_ttybuf = NULL;
533 sclp_tty_buffer_count = 0;
534 if (MACHINE_IS_VM) {
536 * save 4 characters for the CPU number
537 * written at start of each line by VM/CP
539 sclp_tty_columns = 76;
540 /* case input lines to lowercase */
541 sclp_tty_tolower = 1;
543 sclp_tty_chars_count = 0;
545 rc = sclp_register(&sclp_input_event);
546 if (rc) {
547 put_tty_driver(driver);
548 return rc;
551 tty_port_init(&sclp_port);
553 driver->driver_name = "sclp_line";
554 driver->name = "sclp_line";
555 driver->major = TTY_MAJOR;
556 driver->minor_start = 64;
557 driver->type = TTY_DRIVER_TYPE_SYSTEM;
558 driver->subtype = SYSTEM_TYPE_TTY;
559 driver->init_termios = tty_std_termios;
560 driver->init_termios.c_iflag = IGNBRK | IGNPAR;
561 driver->init_termios.c_oflag = ONLCR;
562 driver->init_termios.c_lflag = ISIG | ECHO;
563 driver->flags = TTY_DRIVER_REAL_RAW;
564 tty_set_operations(driver, &sclp_ops);
565 tty_port_link_device(&sclp_port, driver, 0);
566 rc = tty_register_driver(driver);
567 if (rc) {
568 put_tty_driver(driver);
569 tty_port_destroy(&sclp_port);
570 return rc;
572 sclp_tty_driver = driver;
573 return 0;
575 device_initcall(sclp_tty_init);