bsd/netat/adsp_Read.c

   1 /*
   2  * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_OSREFERENCE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License.  The rights granted to you under the
  10  * License may not be used to create, or enable the creation or
  11  * redistribution of, unlawful or unlicensed copies of an Apple operating
  12  * system, or to circumvent, violate, or enable the circumvention or
  13  * violation of, any terms of an Apple operating system software license
  14  * agreement.
  15  *
  16  * Please obtain a copy of the License at
  17  * http://www.opensource.apple.com/apsl/ and read it before using this
  18  * file.
  19  *
  20  * The Original Code and all software distributed under the License are
  21  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  22  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  23  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  24  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  25  * Please see the License for the specific language governing rights and
  26  * limitations under the License.
  27  *
  28  * @APPLE_LICENSE_OSREFERENCE_HEADER_END@
  29  */
  30 /*
  31  *
  32  * dspRead.c
  33  *
  34  * From v01.17 08/22/90 mbs
  35  *    Modified for MP, 1996 by Tuyen Nguyen
  36  *   Modified, April 9, 1997 by Tuyen Nguyen for MacOSX.
  37  */
  38
  39 #include <sys/errno.h>
  40 #include <sys/types.h>
  41 #include <sys/param.h>
  42 #include <machine/spl.h>
  43 #include <sys/systm.h>
  44 #include <sys/kernel.h>
  45 #include <sys/proc.h>
  46 #include <sys/filedesc.h>
  47 #include <sys/fcntl.h>
  48 #include <sys/mbuf.h>
  49 #include <sys/socket.h>
  50 #include <sys/socketvar.h>
  51
  52 #include <netat/sysglue.h>
  53 #include <netat/appletalk.h>
  54 #include <netat/at_pcb.h>
  55 #include <netat/debug.h>
  56 #include <netat/adsp.h>
  57 #include <netat/adsp_internal.h>
  58
  59 /*
  60  * CheckReadQueue
  61  *
  62  * Checks to see if there is any data in the receive queue.  If there
  63  * is data, a pb and the data are queued to the user.
  64  *
  65  *
  66  */
  67 extern int adsp_check;
  68
  69 int CheckReadQueue(sp)          /* (CCBPtr sp) */
  70     register CCBPtr sp;
  71 {
  72     register struct adspcmd *pb;
  73     unsigned short cnt;
  74     char eom = 0;
  75     register gbuf_t *mp;
  76     register gbuf_t *tmp;
  77     gref_t *gref;
  78
  79     dPrintf(D_M_ADSP, D_L_TRACE, ("CheckReadQueue: sp=0x%x\n", (unsigned)sp));
  80     KERNEL_DEBUG(DBG_ADSP_READ, 0, sp, sp->rbuf_mb, sp->rpb, sp->delay);
  81     trace_mbufs(D_M_ADSP_LOW, "    bCQR m", sp->rbuf_mb);
  82
  83     while (sp->rData && (pb = sp->rpb)) {               /* have data */
  84         dPrintf(D_M_ADSP, D_L_TRACE,
  85                  (" pb=0x%x, gref=0x%x, ioc=0x%x, reqCount=%d (have data)\n",
  86                   pb, pb->gref, pb->ioc, pb->u.ioParams.reqCount));
  87         KERNEL_DEBUG(DBG_ADSP_READ, 1, pb, pb->gref, pb->ioc, pb->u.ioParams.reqCount);
  88         if (pb->u.ioParams.reqCount == 0) {
  89             pb->ioResult = 0;
  90             sp->rpb = pb->qLink;
  91             if (pb->ioc) {
  92                 KERNEL_DEBUG(DBG_ADSP_READ, 2, pb, pb->gref, pb->ioc, 0);
  93                 adspioc_ack(0, pb->ioc, pb->gref);
  94             } else {
  95                 KERNEL_DEBUG(DBG_ADSP_READ, 3, pb, pb->gref, 0, 0);
  96                 completepb(sp, pb);
  97             }
  98             continue;
  99         }
 100
 101         /* take the first packet off of sp->rbuf_mb or sp->crbuf_mb */
 102         if (mp = sp->rbuf_mb) { /* Get header for oldest data */
 103             KERNEL_DEBUG(DBG_ADSP_READ, 4, pb, mp, gbuf_msgsize(mp), gbuf_next(mp));
 104             sp->rbuf_mb = gbuf_next(mp);
 105             gbuf_next(mp) = 0;
 106             eom = 1;
 107         } else if (mp = sp->crbuf_mb) {
 108             KERNEL_DEBUG(DBG_ADSP_READ, 5, pb, mp, gbuf_msgsize(mp), gbuf_next(mp));
 109             sp->crbuf_mb = 0;
 110             eom = 0;
 111         }
 112
 113         /* Get the first (reqCount-actCount) bytes and tack them onto
 114            the end of pb->mp.  If eom is set, put the remainder of the
 115            data onto the front of sp->rbuf_mb, otherwise sp->crbuf_mb. */
 116         cnt = gbuf_msgsize(mp); /* # of data bytes in it. */
 117         if (cnt > (unsigned short)(pb->u.ioParams.reqCount - pb->u.ioParams.actCount)) {
 118             cnt = pb->u.ioParams.reqCount - pb->u.ioParams.actCount;
 119             /* m_split returns the tail */
 120             if (!(tmp = (gbuf_t *)m_split(mp, cnt, M_DONTWAIT))) {
 121                 cnt = 0;
 122                 tmp = mp;
 123             }
 124             if (eom) {
 125                 gbuf_next(tmp) = sp->rbuf_mb;
 126                 sp->rbuf_mb = tmp;
 127                 eom = 0;
 128             } else
 129                 sp->crbuf_mb = tmp;
 130         }
 131         if (cnt) {
 132             pb->u.ioParams.actCount += cnt;
 133             gbuf_linkb(pb->mp, mp);
 134         }
 135
 136         pb->u.ioParams.eom = eom;
 137         /*
 138          * Now clean up receive buffer to remove all of the data
 139          * we just copied
 140          */
 141         if ((sp->rbuf_mb == 0) &&
 142             (sp->crbuf_mb == 0)) /* no more data blocks */
 143             sp->rData = 0;
 144         /*
 145          * If we've filled the parameter block, unlink it from read
 146          * queue and complete it. We also need to do this if the connection
 147          * is closed && there is no more stuff to read.
 148          */
 149         if (eom || (pb->u.ioParams.actCount >= pb->u.ioParams.reqCount) ||
 150             ((sp->state == sClosed) && (!sp->rData)) ) {
 151               /* end of message, message is full, connection
 152                * is closed and all data has been delivered,
 153                * or we are not to "delay" data delivery.
 154                */
 155             pb->ioResult = 0;
 156             sp->rpb = pb->qLink; /* dequeue request */
 157             if (pb->ioc) {      /* data to be delivered at the time of the */
 158                 mp = gbuf_cont(pb->mp); /* ioctl call */
 159                 gbuf_cont(pb->mp) = 0;
 160                 gref = (gref_t *)pb->gref;
 161                 adspioc_ack(0, pb->ioc, pb->gref);
 162                 dPrintf(D_M_ADSP, D_L_TRACE, ("    (pb->ioc) mp=%x\n", mp));
 163                 KERNEL_DEBUG(DBG_ADSP_READ, 0x0A, pb,  mp,
 164                              gbuf_next(mp), gbuf_cont(mp));
 165                 SndMsgUp(gref, mp);
 166                 dPrintf(D_M_ADSP, D_L_TRACE,
 167                         ("    (data) size req=%d\n", pb->u.ioParams.actCount));
 168                 KERNEL_DEBUG(DBG_ADSP_READ, 0x0B, pb, pb->ioc,
 169                              pb->u.ioParams.reqCount, pb->u.ioParams.actCount);
 170             } else {            /* complete an queued async request */
 171                 KERNEL_DEBUG(DBG_ADSP_READ, 0x0C, pb, sp,
 172                              pb->u.ioParams.actCount, sp->delay);
 173                 completepb(sp, pb);
 174             }
 175         }
 176     }   /* while */
 177
 178     if (pb = sp->rpb) {         /* if there is an outstanding request */
 179         dPrintf(D_M_ADSP, D_L_TRACE,
 180                  (" pb=0x%x, ioc=0x%x, reqCount=%d (no more data)\n",
 181                   pb, pb->ioc, pb->u.ioParams.reqCount));
 182         KERNEL_DEBUG(DBG_ADSP_READ, 0x0D, pb, pb->ioc,
 183                      pb->u.ioParams.reqCount, pb->u.ioParams.actCount);
 184
 185         if (sp->state == sClosed) {
 186             while (pb) {
 187                     KERNEL_DEBUG(DBG_ADSP_READ, 0x0E, pb, sp, pb->ioc, 0);
 188                     pb->ioResult = 0;
 189                     pb->u.ioParams.actCount = 0;
 190                     pb->u.ioParams.eom = 0;
 191                     sp->rpb = pb->qLink;
 192                     if (pb->ioc) {
 193                             adspioc_ack(0, pb->ioc, pb->gref);
 194                     } else {
 195                             completepb(sp, pb);
 196                     }
 197                     pb = sp->rpb;
 198             }
 199         } else if (pb->ioc) {   /* if request not complete and this
 200                                  * is an active ioctl, release user */
 201             sp->rpb = pb->qLink;
 202             pb->ioResult = 1;
 203             tmp = gbuf_cont(pb->mp); /* detatch perhaps delayed data */
 204             gbuf_cont(pb->mp) = 0;
 205             if (mp = gbuf_copym(pb->mp)) { /* otherwise, duplicate user request */
 206                     KERNEL_DEBUG(DBG_ADSP_READ, 0x0F, pb, sp, pb->mp, 0);
 207                     adspioc_ack(0, pb->ioc, pb->gref);  /* release user */
 208                     pb = (struct adspcmd *)gbuf_rptr(mp); /* get new parameter block */
 209                     pb->ioc = 0;
 210                     pb->mp = mp;
 211                     gbuf_cont(pb->mp) = tmp; /* reattach data */
 212                     pb->qLink = sp->rpb; /* requeue the duplicate at the head */
 213                     sp->rpb = pb;
 214             } else {            /* there is no data left, but no space
 215                                  * to duplicate the parameter block, so
 216                                  * put what must be a non EOM message
 217                                  * back on the current receive queue, and
 218                                  * error out the user
 219                                  */
 220                     KERNEL_DEBUG(DBG_ADSP_READ, 0x10, pb, sp, pb->mp, 0);
 221                     if (tmp) {
 222                             sp->crbuf_mb = tmp;
 223                             sp->rData = 1;
 224                     }
 225                     pb->ioResult = errDSPQueueSize;
 226                     adspioc_ack(ENOBUFS, pb->ioc, pb->gref);
 227             }
 228         }
 229     }
 230     /*
 231      * The receive window has opened.  If was previously closed, then we
 232      * need to notify the other guy that we now have room to receive more
 233      * data.  But, in order to cut down on lots of small data packets,
 234      * we'll wait until the recieve buffer  is /14 empy before telling
 235      * him that there's room in our receive buffer.
 236      */
 237     if (sp->rbufFull && (CalcRecvWdw(sp) > (sp->rbuflen >> 2))) {
 238         sp->rbufFull = 0;
 239         sp->sendDataAck = 1;
 240         sp->callSend = 1;
 241     }
 242
 243     KERNEL_DEBUG(DBG_ADSP_READ, 0x11, sp, 0, 0, 0);
 244     trace_mbufs(D_M_ADSP_LOW, "    eCQR m", sp->rbuf_mb);
 245     return 0;
 246 }
 247
 248 /*
 249  * CheckAttn
 250  *
 251  * Checks to see if there is any attention data and passes the data back
 252  * in the passed in pb.
 253  *
 254  * INPUTS:
 255  *      sp
 256  *      pb
 257  *
 258  * OUTPUTS:
 259  *
 260  */
 261 int CheckAttn(sp, pb)           /* (CCBPtr sp) */
 262     register CCBPtr sp;
 263     register struct adspcmd *pb;
 264 {
 265     gbuf_t *mp;
 266     gref_t *gref;
 267
 268     dPrintf(D_M_ADSP, D_L_TRACE,
 269             ("CheckAttn: sp=0x%x, pb=0x%x\n", (unsigned)sp, (unsigned)pb));
 270
 271     if (mp = sp->attn_mb) {
 272
 273         /*
 274          * Deliver the attention data to the user.
 275          */
 276         gref = (gref_t *)pb->gref;
 277         pb->u.attnParams.attnSize = sp->attnSize;
 278         pb->u.attnParams.attnCode = sp->attnCode;
 279         if (!sp->attnSize) {
 280             gbuf_freem(mp);
 281             mp = 0;
 282         }
 283         sp->userFlags &= ~eAttention;
 284         /*
 285          * Now clean up receive buffer to remove all of the data
 286          * we just copied
 287          */
 288         sp->attn_mb = 0;
 289         pb->ioResult = 0;
 290     } else {
 291         /*
 292          * No data...
 293          */
 294         pb->u.attnParams.attnSize = 0;
 295         pb->u.attnParams.attnCode = 0;
 296         pb->ioResult = 1;       /* not done */
 297     }
 298     adspioc_ack(0, pb->ioc, pb->gref);
 299     if (mp) {
 300         SndMsgUp(gref, mp);
 301         }
 302     return 0;
 303 }
 304
 305 /*
 306  * adspRead
 307  *
 308  * INPUTS:
 309  *      --> sp                  stream pointer
 310  *      --> pb                  user request parameter block
 311  *
 312  * OUTPUTS:
 313  *      <-- actCount            actual number of bytes read
 314  *      <-- eom                 one if end-of-message, zero otherwise
 315  *
 316  * ERRORS:
 317  *      errRefNum               bad connection refnum
 318  *      errState
 319  *      errFwdReset             read terminated by forward reset
 320  *      errAborted              request aborted by Remove or Close call
 321  */
 322 int adspRead(sp, pb)            /* (DSPPBPtr pb) */
 323     register CCBPtr sp;
 324     register struct adspcmd *pb;
 325 {
 326     register gbuf_t *mp;
 327
 328     dPrintf(D_M_ADSP, D_L_TRACE,
 329             ("adspRead: sp=0x%x, pb=0x%x\n", (unsigned)sp, (unsigned)pb));
 330
 331     KERNEL_DEBUG(DBG_ADSP_READ, 0x12, sp, pb, sp->state, sp->rData);
 332
 333     if (sp == 0) {
 334         pb->ioResult = errRefNum;
 335         return EINVAL;
 336     }
 337
 338     /*
 339      * It's OK to read on a closed, or closing session
 340      */
 341     if (sp->state != sOpen && sp->state != sClosing && sp->state != sClosed) {
 342         pb->ioResult = errState;
 343         return EINVAL;
 344     }
 345     if (sp->rData && (sp->rpb == 0)) { /* if data, and no queue of pbs */
 346         qAddToEnd(&sp->rpb, pb); /* deliver data to user directly */
 347         CheckReadQueue(sp);
 348     } else if ((pb->u.ioParams.reqCount == 0) && (sp->rpb == 0)) {
 349             /* empty read */
 350             pb->ioResult = 0;
 351             adspioc_ack(0, pb->ioc, pb->gref);
 352             return 0;
 353     } else {
 354         pb->ioResult = 1;
 355         if (mp = gbuf_copym(pb->mp)) { /* otherwise, duplicate user request */
 356                 adspioc_ack(0, pb->ioc, pb->gref);      /* release user */
 357                 pb = (struct adspcmd *)gbuf_rptr(mp);   /* get new parameter block */
 358                 pb->ioc = 0;
 359                 pb->mp = mp;
 360                 qAddToEnd(&sp->rpb, pb); /* and queue it for later */
 361         } else {
 362                 pb->ioResult = errDSPQueueSize;
 363                 return ENOBUFS;
 364         }
 365     }
 366
 367     if (sp->callSend) {
 368         CheckSend(sp);          /* If recv window opened, we might */
 369                                 /* send an unsolicited ACK. */
 370     }
 371     return 0;
 372 }
 373
 374 /*
 375  * dspReadAttention
 376  *
 377  * INPUTS:
 378  *      --> sp                  stream pointer
 379  *      --> pb                  user request parameter block
 380  *
 381  * OUTPUTS:
 382  *      <-- NONE
 383  *
 384  * ERRORS:
 385  *      errRefNum               bad connection refnum
 386  *      errState                connection is not in the right state
 387  */
 388 int adspReadAttention(sp, pb)           /* (DSPPBPtr pb) */
 389     register CCBPtr sp;
 390     register struct adspcmd *pb;
 391 {
 392     dPrintf(D_M_ADSP, D_L_TRACE,
 393             ("adspReadAttention: sp=0x%x, pb=0x%x\n", (unsigned)sp, (unsigned)pb));
 394     if (sp == 0) {
 395         pb->ioResult = errRefNum;
 396         return EINVAL;
 397     }
 398
 399     /*
 400      * It's OK to read on a closed, or closing session
 401      */
 402     if (sp->state != sOpen && sp->state != sClosing && sp->state != sClosed) {
 403         pb->ioResult = errState;
 404         return EINVAL;
 405     }
 406
 407     CheckAttn(sp, pb);          /* Anything in the attention queue */
 408     CheckReadQueue(sp);         /* check to see if receive window has opened */
 409     if (sp->callSend) {
 410         CheckSend(sp);          /* If recv window opened, we might */
 411                                 /* send an unsolicited ACK. */
 412         }
 413     return 0;
 414 } /* adspReadAttention */