The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/dev/snp/snp.c

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 /*-
    2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
    3  *
    4  * Copyright (c) 2008 Ed Schouten <ed@FreeBSD.org>
    5  * All rights reserved.
    6  *
    7  * Redistribution and use in source and binary forms, with or without
    8  * modification, are permitted provided that the following conditions
    9  * are met:
   10  * 1. Redistributions of source code must retain the above copyright
   11  *    notice, this list of conditions and the following disclaimer.
   12  * 2. Redistributions in binary form must reproduce the above copyright
   13  *    notice, this list of conditions and the following disclaimer in the
   14  *    documentation and/or other materials provided with the distribution.
   15  *
   16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
   17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
   20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   26  * SUCH DAMAGE.
   27  */
   28 
   29 #include <sys/cdefs.h>
   30 __FBSDID("$FreeBSD$");
   31 
   32 #include <sys/param.h>
   33 #include <sys/conf.h>
   34 #include <sys/fcntl.h>
   35 #include <sys/filio.h>
   36 #include <sys/kernel.h>
   37 #include <sys/malloc.h>
   38 #include <sys/module.h>
   39 #include <sys/poll.h>
   40 #include <sys/proc.h>
   41 #include <sys/snoop.h>
   42 #include <sys/sx.h>
   43 #include <sys/systm.h>
   44 #include <sys/tty.h>
   45 #include <sys/uio.h>
   46 
   47 static struct cdev      *snp_dev;
   48 static MALLOC_DEFINE(M_SNP, "snp", "tty snoop device");
   49 
   50 /* XXX: should be mtx, but TTY can be locked by Giant. */
   51 #if 0
   52 static struct mtx       snp_register_lock;
   53 MTX_SYSINIT(snp_register_lock, &snp_register_lock,
   54     "tty snoop registration", MTX_DEF);
   55 #define SNP_LOCK()      mtx_lock(&snp_register_lock)
   56 #define SNP_UNLOCK()    mtx_unlock(&snp_register_lock)
   57 #else
   58 static struct sx        snp_register_lock;
   59 SX_SYSINIT(snp_register_lock, &snp_register_lock,
   60     "tty snoop registration");
   61 #define SNP_LOCK()      sx_xlock(&snp_register_lock)
   62 #define SNP_UNLOCK()    sx_xunlock(&snp_register_lock)
   63 #endif
   64 
   65 #define SNPGTYY_32DEV   _IOR('T', 89, uint32_t)
   66 
   67 /*
   68  * There is no need to have a big input buffer. In most typical setups,
   69  * we won't inject much data into the TTY, because users can't type
   70  * really fast.
   71  */
   72 #define SNP_INPUT_BUFSIZE       16
   73 /*
   74  * The output buffer has to be really big. Right now we don't support
   75  * any form of flow control, which means we lost any data we can't
   76  * accept. We set the output buffer size to about twice the size of a
   77  * pseudo-terminal/virtual console's output buffer.
   78  */
   79 #define SNP_OUTPUT_BUFSIZE      16384
   80 
   81 static d_open_t         snp_open;
   82 static d_read_t         snp_read;
   83 static d_write_t        snp_write;
   84 static d_ioctl_t        snp_ioctl;
   85 static d_poll_t         snp_poll;
   86 
   87 static struct cdevsw snp_cdevsw = {
   88         .d_version      = D_VERSION,
   89         .d_open         = snp_open,
   90         .d_read         = snp_read,
   91         .d_write        = snp_write,
   92         .d_ioctl        = snp_ioctl,
   93         .d_poll         = snp_poll,
   94         .d_name         = "snp",
   95 };
   96 
   97 static th_getc_capture_t        snp_getc_capture;
   98 
   99 static struct ttyhook snp_hook = {
  100         .th_getc_capture        = snp_getc_capture,
  101 };
  102 
  103 /*
  104  * Per-instance structure.
  105  *
  106  * List of locks
  107  * (r)  locked by snp_register_lock on assignment
  108  * (t)  locked by tty_lock
  109  */
  110 struct snp_softc {
  111         struct tty      *snp_tty;       /* (r) TTY we're snooping. */
  112         struct ttyoutq  snp_outq;       /* (t) Output queue. */
  113         struct cv       snp_outwait;    /* (t) Output wait queue. */
  114         struct selinfo  snp_outpoll;    /* (t) Output polling. */
  115 };
  116 
  117 static void
  118 snp_dtor(void *data)
  119 {
  120         struct snp_softc *ss = data;
  121         struct tty *tp;
  122 
  123         tp = ss->snp_tty;
  124         if (tp != NULL) {
  125                 tty_lock(tp);
  126                 ttyoutq_free(&ss->snp_outq);
  127                 ttyhook_unregister(tp);
  128                 ss->snp_tty = NULL;
  129         }
  130 
  131         cv_destroy(&ss->snp_outwait);
  132         free(ss, M_SNP);
  133 }
  134 
  135 /*
  136  * Snoop device node routines.
  137  */
  138 
  139 static int
  140 snp_open(struct cdev *dev, int flag, int mode, struct thread *td)
  141 {
  142         struct snp_softc *ss;
  143 
  144         /* Allocate per-snoop data. */
  145         ss = malloc(sizeof(struct snp_softc), M_SNP, M_WAITOK|M_ZERO);
  146         cv_init(&ss->snp_outwait, "snp out");
  147 
  148         devfs_set_cdevpriv(ss, snp_dtor);
  149 
  150         return (0);
  151 }
  152 
  153 static int
  154 snp_read(struct cdev *dev, struct uio *uio, int flag)
  155 {
  156         int error, oresid = uio->uio_resid;
  157         struct snp_softc *ss;
  158         struct tty *tp;
  159 
  160         if (uio->uio_resid == 0)
  161                 return (0);
  162 
  163         error = devfs_get_cdevpriv((void **)&ss);
  164         if (error != 0)
  165                 return (error);
  166 
  167         tp = ss->snp_tty;
  168         if (tp == NULL || tty_gone(tp))
  169                 return (EIO);
  170 
  171         tty_lock(tp);
  172         for (;;) {
  173                 error = ttyoutq_read_uio(&ss->snp_outq, tp, uio);
  174                 if (error != 0 || uio->uio_resid != oresid)
  175                         break;
  176 
  177                 /* Wait for more data. */
  178                 if (flag & O_NONBLOCK) {
  179                         error = EWOULDBLOCK;
  180                         break;
  181                 }
  182                 error = cv_wait_sig(&ss->snp_outwait, tty_getlock(tp));
  183                 if (error != 0)
  184                         break;
  185                 if (tty_gone(tp)) {
  186                         error = EIO;
  187                         break;
  188                 }
  189         }
  190         tty_unlock(tp);
  191 
  192         return (error);
  193 }
  194 
  195 static int
  196 snp_write(struct cdev *dev, struct uio *uio, int flag)
  197 {
  198         struct snp_softc *ss;
  199         struct tty *tp;
  200         int error, len;
  201         char in[SNP_INPUT_BUFSIZE];
  202 
  203         error = devfs_get_cdevpriv((void **)&ss);
  204         if (error != 0)
  205                 return (error);
  206 
  207         tp = ss->snp_tty;
  208         if (tp == NULL || tty_gone(tp))
  209                 return (EIO);
  210 
  211         while (uio->uio_resid > 0) {
  212                 /* Read new data. */
  213                 len = imin(uio->uio_resid, sizeof in);
  214                 error = uiomove(in, len, uio);
  215                 if (error != 0)
  216                         return (error);
  217 
  218                 tty_lock(tp);
  219 
  220                 /* Driver could have abandoned the TTY in the mean time. */
  221                 if (tty_gone(tp)) {
  222                         tty_unlock(tp);
  223                         return (ENXIO);
  224                 }
  225 
  226                 /*
  227                  * Deliver data to the TTY. Ignore errors for now,
  228                  * because we shouldn't bail out when we're running
  229                  * close to the watermarks.
  230                  */
  231                 ttydisc_rint_simple(tp, in, len);
  232                 ttydisc_rint_done(tp);
  233 
  234                 tty_unlock(tp);
  235         }
  236 
  237         return (0);
  238 }
  239 
  240 static int
  241 snp_ioctl(struct cdev *dev, u_long cmd, caddr_t data, int flags,
  242     struct thread *td)
  243 {
  244         struct snp_softc *ss;
  245         struct tty *tp;
  246         int error;
  247 
  248         error = devfs_get_cdevpriv((void **)&ss);
  249         if (error != 0)
  250                 return (error);
  251 
  252         switch (cmd) {
  253         case SNPSTTY:
  254                 /* Bind TTY to snoop instance. */
  255                 SNP_LOCK();
  256                 tp = ss->snp_tty;
  257                 if (tp != NULL) {
  258                         if (*(int *)data == -1) {
  259                                 tty_lock(tp);
  260                                 ss->snp_tty = NULL;
  261                                 ttyoutq_free(&ss->snp_outq);
  262                                 ttyhook_unregister(tp);
  263                                 error = 0;
  264                         } else {
  265                                 error = EBUSY;
  266                         }
  267                         SNP_UNLOCK();
  268                         return (error);
  269                 }
  270                 /*
  271                  * XXXRW / XXXJA: no capability check here.
  272                  */
  273                 error = ttyhook_register(&ss->snp_tty, td->td_proc,
  274                     *(int *)data, &snp_hook, ss);
  275                 SNP_UNLOCK();
  276                 if (error != 0)
  277                         return (error);
  278 
  279                 /* Now that went okay, allocate a buffer for the queue. */
  280                 tp = ss->snp_tty;
  281                 tty_lock(tp);
  282                 ttyoutq_setsize(&ss->snp_outq, tp, SNP_OUTPUT_BUFSIZE);
  283                 tty_unlock(tp);
  284 
  285                 return (0);
  286         case SNPGTTY:
  287                 /* Obtain device number of associated TTY. */
  288                 if (ss->snp_tty == NULL)
  289                         *(dev_t *)data = NODEV;
  290                 else
  291                         *(dev_t *)data = tty_udev(ss->snp_tty);
  292                 return (0);
  293         case SNPGTYY_32DEV:
  294                 if (ss->snp_tty == NULL)
  295                         *(uint32_t *)data = -1;
  296                 else
  297                         *(uint32_t *)data = tty_udev(ss->snp_tty); /* trunc */
  298                 return (0);
  299         case FIONREAD:
  300                 tp = ss->snp_tty;
  301                 if (tp != NULL) {
  302                         tty_lock(tp);
  303                         if (tty_gone(tp))
  304                                 *(int *)data = SNP_TTYCLOSE;
  305                         else
  306                                 *(int *)data = ttyoutq_bytesused(&ss->snp_outq);
  307                         tty_unlock(tp);
  308                 } else {
  309                         *(int *)data = SNP_DETACH;
  310                 }
  311                 return (0);
  312         default:
  313                 return (ENOTTY);
  314         }
  315 }
  316 
  317 static int
  318 snp_poll(struct cdev *dev, int events, struct thread *td)
  319 {
  320         struct snp_softc *ss;
  321         struct tty *tp;
  322         int revents;
  323 
  324         if (devfs_get_cdevpriv((void **)&ss) != 0)
  325                 return (events &
  326                     (POLLHUP|POLLIN|POLLRDNORM|POLLOUT|POLLWRNORM));
  327 
  328         revents = 0;
  329 
  330         if (events & (POLLIN | POLLRDNORM)) {
  331                 tp = ss->snp_tty;
  332                 if (tp != NULL) {
  333                         tty_lock(tp);
  334                         if (ttyoutq_bytesused(&ss->snp_outq) > 0)
  335                                 revents |= events & (POLLIN | POLLRDNORM);
  336                         tty_unlock(tp);
  337                 }
  338         }
  339 
  340         if (revents == 0)
  341                 selrecord(td, &ss->snp_outpoll);
  342 
  343         return (revents);
  344 }
  345 
  346 /*
  347  * TTY hook events.
  348  */
  349 
  350 static int
  351 snp_modevent(module_t mod, int type, void *data)
  352 {
  353 
  354         switch (type) {
  355         case MOD_LOAD:
  356                 snp_dev = make_dev(&snp_cdevsw, 0,
  357                     UID_ROOT, GID_WHEEL, 0600, "snp");
  358                 return (0);
  359         case MOD_UNLOAD:
  360                 /* XXX: Make existing users leave. */
  361                 destroy_dev(snp_dev);
  362                 return (0);
  363         default:
  364                 return (EOPNOTSUPP);
  365         }
  366 }
  367 
  368 static void
  369 snp_getc_capture(struct tty *tp, const void *buf, size_t len)
  370 {
  371         struct snp_softc *ss = ttyhook_softc(tp);
  372 
  373         ttyoutq_write(&ss->snp_outq, buf, len);
  374 
  375         cv_broadcast(&ss->snp_outwait);
  376         selwakeup(&ss->snp_outpoll);
  377 }
  378 
  379 static moduledata_t snp_mod = {
  380         "snp",
  381         snp_modevent,
  382         NULL
  383 };
  384 
  385 DECLARE_MODULE(snp, snp_mod, SI_SUB_DRIVERS, SI_ORDER_MIDDLE);

Cache object: 140b5f4468c5bb887e17f76477165064


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.