2 * Copyright (c) 1997, 1998 Justin T. Gibbs.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions, and the following disclaimer,
10 * without modification, immediately at the beginning of the file.
11 * 2. The name of the author may not be used to endorse or promote products
12 * derived from this software without specific prior written permission.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
18 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * $FreeBSD: src/sys/i386/i386/busdma_machdep.c,v 1.16.2.2 2003/01/23 00:55:27 scottl Exp $
27 * $DragonFly: src/sys/platform/pc32/i386/busdma_machdep.c,v 1.23 2008/06/05 18:06:32 swildner Exp $
30 #include <sys/param.h>
31 #include <sys/systm.h>
32 #include <sys/malloc.h>
35 #include <sys/thread2.h>
36 #include <sys/bus_dma.h>
37 #include <sys/kernel.h>
38 #include <sys/sysctl.h>
41 #include <vm/vm_page.h>
43 /* XXX needed for to access pmap to convert per-proc virtual to physical */
46 #include <vm/vm_map.h>
48 #include <machine/md_var.h>
50 #define MAX_BPAGES 1024
58 bus_dma_filter_t *filter;
66 bus_dma_segment_t *segments;
70 * bus_dma_tag private flags
72 #define BUS_DMA_COULD_BOUNCE BUS_DMA_BUS3
73 #define BUS_DMA_MIN_ALLOC_COMP BUS_DMA_BUS4
76 vm_offset_t vaddr; /* kva of bounce buffer */
77 bus_addr_t busaddr; /* Physical address */
78 vm_offset_t datavaddr; /* kva of client data */
79 bus_size_t datacount; /* client data count */
80 STAILQ_ENTRY(bounce_page) links;
83 int busdma_swi_pending;
85 static STAILQ_HEAD(bp_list, bounce_page) bounce_page_list;
86 static int free_bpages;
87 static int reserved_bpages;
88 static int active_bpages;
89 static int total_bpages;
90 static bus_addr_t bounce_lowaddr = BUS_SPACE_MAXADDR;
93 struct bp_list bpages;
97 void *buf; /* unmapped buffer pointer */
98 bus_size_t buflen; /* unmapped buffer length */
99 bus_dmamap_callback_t *callback;
101 STAILQ_ENTRY(bus_dmamap) links;
104 static STAILQ_HEAD(, bus_dmamap) bounce_map_waitinglist;
105 static STAILQ_HEAD(, bus_dmamap) bounce_map_callbacklist;
106 static struct bus_dmamap nobounce_dmamap;
108 static int alloc_bounce_pages(bus_dma_tag_t, u_int);
109 static int reserve_bounce_pages(bus_dma_tag_t, bus_dmamap_t);
110 static bus_addr_t add_bounce_page(bus_dma_tag_t, bus_dmamap_t,
111 vm_offset_t, bus_size_t);
112 static void free_bounce_page(bus_dma_tag_t, struct bounce_page *);
114 SYSCTL_NODE(_hw, OID_AUTO, busdma, CTLFLAG_RD, 0, "Busdma parameters");
115 SYSCTL_INT(_hw_busdma, OID_AUTO, total_bpages, CTLFLAG_RD, &total_bpages, 0,
116 "Total bounce pages");
119 run_filter(bus_dma_tag_t dmat, bus_addr_t paddr)
125 if (paddr > dmat->lowaddr
126 && paddr <= dmat->highaddr
127 && (dmat->filter == NULL
128 || (*dmat->filter)(dmat->filterarg, paddr) != 0))
132 } while (retval == 0 && dmat != NULL);
137 * Allocate a device specific dma_tag.
140 bus_dma_tag_create(bus_dma_tag_t parent, bus_size_t alignment,
141 bus_size_t boundary, bus_addr_t lowaddr,
142 bus_addr_t highaddr, bus_dma_filter_t *filter,
143 void *filterarg, bus_size_t maxsize, int nsegments,
144 bus_size_t maxsegsz, int flags, bus_dma_tag_t *dmat)
146 bus_dma_tag_t newtag;
149 /* Return a NULL tag on failure */
152 newtag = kmalloc(sizeof(*newtag), M_DEVBUF, M_INTWAIT);
154 newtag->parent = parent;
155 newtag->alignment = alignment;
156 newtag->boundary = boundary;
157 newtag->lowaddr = trunc_page((vm_paddr_t)lowaddr) + (PAGE_SIZE - 1);
158 newtag->highaddr = trunc_page((vm_paddr_t)highaddr) + (PAGE_SIZE - 1);
159 newtag->filter = filter;
160 newtag->filterarg = filterarg;
161 newtag->maxsize = maxsize;
162 newtag->nsegments = nsegments;
163 newtag->maxsegsz = maxsegsz;
164 newtag->flags = flags;
165 newtag->ref_count = 1; /* Count ourself */
166 newtag->map_count = 0;
167 newtag->segments = NULL;
169 /* Take into account any restrictions imposed by our parent tag */
170 if (parent != NULL) {
171 newtag->lowaddr = MIN(parent->lowaddr, newtag->lowaddr);
172 newtag->highaddr = MAX(parent->highaddr, newtag->highaddr);
174 if (newtag->boundary == 0) {
175 newtag->boundary = parent->boundary;
176 } else if (parent->boundary != 0) {
177 newtag->boundary = MIN(parent->boundary,
181 if (newtag->filter == NULL) {
183 * Short circuit looking at our parent directly
184 * since we have encapsulated all of its information
186 newtag->filter = parent->filter;
187 newtag->filterarg = parent->filterarg;
188 newtag->parent = parent->parent;
190 if (newtag->parent != NULL)
194 if (newtag->lowaddr < ptoa(Maxmem))
195 newtag->flags |= BUS_DMA_COULD_BOUNCE;
197 if ((newtag->flags & BUS_DMA_COULD_BOUNCE) &&
198 (flags & BUS_DMA_ALLOCNOW) != 0) {
201 if (lowaddr > bounce_lowaddr) {
203 * Go through the pool and kill any pages
204 * that don't reside below lowaddr.
206 panic("bus_dma_tag_create: page reallocation "
209 if (ptoa(total_bpages) < maxsize) {
212 pages = atop(maxsize) - total_bpages;
214 /* Add pages to our bounce pool */
215 if (alloc_bounce_pages(newtag, pages) < pages)
218 /* Performed initial allocation */
219 newtag->flags |= BUS_DMA_MIN_ALLOC_COMP;
223 kfree(newtag, M_DEVBUF);
231 bus_dma_tag_destroy(bus_dma_tag_t dmat)
234 if (dmat->map_count != 0)
237 while (dmat != NULL) {
238 bus_dma_tag_t parent;
240 parent = dmat->parent;
242 if (dmat->ref_count == 0) {
243 if (dmat->segments != NULL)
244 kfree(dmat->segments, M_DEVBUF);
245 kfree(dmat, M_DEVBUF);
247 * Last reference count, so
248 * release our reference
249 * count on our parent.
260 * Allocate a handle for mapping from kva/uva/physical
261 * address space into bus device space.
264 bus_dmamap_create(bus_dma_tag_t dmat, int flags, bus_dmamap_t *mapp)
270 if (dmat->segments == NULL) {
271 KKASSERT(dmat->nsegments && dmat->nsegments < 16384);
272 dmat->segments = kmalloc(sizeof(bus_dma_segment_t) *
273 dmat->nsegments, M_DEVBUF, M_INTWAIT);
276 if (dmat->flags & BUS_DMA_COULD_BOUNCE) {
280 *mapp = kmalloc(sizeof(**mapp), M_DEVBUF, M_INTWAIT | M_ZERO);
282 /* Initialize the new map */
283 STAILQ_INIT(&((*mapp)->bpages));
285 * Attempt to add pages to our pool on a per-instance
286 * basis up to a sane limit.
288 maxpages = MIN(MAX_BPAGES, Maxmem - atop(dmat->lowaddr));
289 if ((dmat->flags & BUS_DMA_MIN_ALLOC_COMP) == 0
290 || (dmat->map_count > 0
291 && total_bpages < maxpages)) {
294 if (dmat->lowaddr > bounce_lowaddr) {
296 * Go through the pool and kill any pages
297 * that don't reside below lowaddr.
299 panic("bus_dmamap_create: page reallocation "
303 pages = MAX(atop(dmat->maxsize), 1);
304 pages = MIN(maxpages - total_bpages, pages);
305 pages = MAX(pages, 1);
306 if (alloc_bounce_pages(dmat, pages) < pages)
309 if ((dmat->flags & BUS_DMA_MIN_ALLOC_COMP) == 0) {
311 dmat->flags |= BUS_DMA_MIN_ALLOC_COMP;
325 * Destroy a handle for mapping from kva/uva/physical
326 * address space into bus device space.
329 bus_dmamap_destroy(bus_dma_tag_t dmat, bus_dmamap_t map)
332 if (STAILQ_FIRST(&map->bpages) != NULL)
334 kfree(map, M_DEVBUF);
341 * Allocate a piece of memory that can be efficiently mapped into
342 * bus device space based on the constraints lited in the dma tag.
344 * mapp is degenerate. By definition this allocation should not require
345 * bounce buffers so do not allocate a dma map.
348 bus_dmamem_alloc(bus_dma_tag_t dmat, void** vaddr, int flags,
353 /* If we succeed, no mapping/bouncing will be required */
356 if (dmat->segments == NULL) {
357 KKASSERT(dmat->nsegments < 16384);
358 dmat->segments = kmalloc(sizeof(bus_dma_segment_t) *
359 dmat->nsegments, M_DEVBUF, M_INTWAIT);
362 if (flags & BUS_DMA_NOWAIT)
366 if (flags & BUS_DMA_ZERO)
369 if ((dmat->maxsize <= PAGE_SIZE) &&
370 dmat->lowaddr >= ptoa(Maxmem)) {
371 *vaddr = kmalloc(dmat->maxsize, M_DEVBUF, mflags);
373 * XXX Check whether the allocation crossed a page boundary
374 * and retry with power-of-2 alignment in that case.
376 if ((((intptr_t)*vaddr) & PAGE_MASK) !=
377 (((intptr_t)*vaddr + dmat->maxsize) & PAGE_MASK)) {
380 kfree(*vaddr, M_DEVBUF);
381 /* XXX check for overflow? */
382 for (size = 1; size <= dmat->maxsize; size <<= 1)
384 *vaddr = kmalloc(size, M_DEVBUF, mflags);
388 * XXX Use Contigmalloc until it is merged into this facility
389 * and handles multi-seg allocations. Nobody is doing
390 * multi-seg allocations yet though.
392 *vaddr = contigmalloc(dmat->maxsize, M_DEVBUF, mflags,
393 0ul, dmat->lowaddr, dmat->alignment? dmat->alignment : 1ul,
402 * Free a piece of memory and it's allociated dmamap, that was allocated
403 * via bus_dmamem_alloc. Make the same choice for free/contigfree.
406 bus_dmamem_free(bus_dma_tag_t dmat, void *vaddr, bus_dmamap_t map)
409 * dmamem does not need to be bounced, so the map should be
413 panic("bus_dmamem_free: Invalid map freed\n");
414 if ((dmat->maxsize <= PAGE_SIZE) &&
415 dmat->lowaddr >= ptoa(Maxmem))
416 kfree(vaddr, M_DEVBUF);
418 contigfree(vaddr, dmat->maxsize, M_DEVBUF);
421 #define BUS_DMAMAP_NSEGS ((BUS_SPACE_MAXSIZE / PAGE_SIZE) + 1)
424 * Map the buffer buf into bus space using the dmamap map.
427 bus_dmamap_load(bus_dma_tag_t dmat, bus_dmamap_t map, void *buf,
428 bus_size_t buflen, bus_dmamap_callback_t *callback,
429 void *callback_arg, int flags)
432 vm_paddr_t paddr, nextpaddr;
433 bus_dma_segment_t *sg;
438 map = &nobounce_dmamap;
442 * If we are being called during a callback, pagesneeded will
443 * be non-zero, so we can avoid doing the work twice.
445 if ((dmat->flags & BUS_DMA_COULD_BOUNCE) &&
446 map->pagesneeded == 0) {
447 vm_offset_t vendaddr;
450 * Count the number of bounce pages
451 * needed in order to complete this transfer
453 vaddr = trunc_page((vm_offset_t)buf);
454 vendaddr = (vm_offset_t)buf + buflen;
456 while (vaddr < vendaddr) {
457 paddr = pmap_kextract(vaddr);
458 if (run_filter(dmat, paddr) != 0)
464 /* Reserve Necessary Bounce Pages */
465 if (map->pagesneeded != 0) {
467 if (reserve_bounce_pages(dmat, map) != 0) {
468 /* Queue us for resources */
471 map->buflen = buflen;
472 map->callback = callback;
473 map->callback_arg = callback_arg;
475 STAILQ_INSERT_TAIL(&bounce_map_waitinglist, map, links);
478 return (EINPROGRESS);
483 vaddr = (vm_offset_t)buf;
488 bmask = ~(dmat->boundary - 1); /* note: will be 0 if boundary is 0 */
490 /* force at least one segment */
497 paddr = pmap_kextract(vaddr);
498 size = PAGE_SIZE - (paddr & PAGE_MASK);
501 if (map->pagesneeded != 0 && run_filter(dmat, paddr)) {
503 * note: this paddr has the same in-page offset
504 * as vaddr and thus the paddr above, so the
505 * size does not have to be recalculated
507 paddr = add_bounce_page(dmat, map, vaddr, size);
511 * Fill in the bus_dma_segment
513 if (sg->ds_len == 0) {
516 } else if (paddr == nextpaddr) {
521 if (seg > dmat->nsegments)
526 nextpaddr = paddr + size;
529 * Handle maxsegsz and boundary issues with a nested loop
535 * Limit to the boundary and maximum segment size
537 if (((nextpaddr - 1) ^ sg->ds_addr) & bmask) {
538 tmpsize = dmat->boundary -
539 (sg->ds_addr & ~bmask);
540 if (tmpsize > dmat->maxsegsz)
541 tmpsize = dmat->maxsegsz;
542 KKASSERT(tmpsize < sg->ds_len);
543 } else if (sg->ds_len > dmat->maxsegsz) {
544 tmpsize = dmat->maxsegsz;
550 * Futz, split the data into a new segment.
552 if (seg >= dmat->nsegments)
554 sg[1].ds_len = sg[0].ds_len - tmpsize;
555 sg[1].ds_addr = sg[0].ds_addr + tmpsize;
556 sg[0].ds_len = tmpsize;
566 } while (buflen > 0);
570 kprintf("bus_dmamap_load: Too many segs! buf_len = 0x%lx\n",
575 (*callback)(callback_arg, dmat->segments, seg, error);
581 * Utility function to load a linear buffer. lastaddrp holds state
582 * between invocations (for multiple-buffer loads). segp contains
583 * the starting segment on entrace, and the ending segment on exit.
584 * first indicates if this is the first invocation of this function.
587 _bus_dmamap_load_buffer(bus_dma_tag_t dmat,
588 void *buf, bus_size_t buflen,
591 vm_offset_t *lastaddrp,
595 bus_dma_segment_t *segs;
597 bus_addr_t curaddr, lastaddr, baddr, bmask;
598 vm_offset_t vaddr = (vm_offset_t)buf;
602 if (td->td_proc != NULL)
603 pmap = vmspace_pmap(td->td_proc->p_vmspace);
607 segs = dmat->segments;
608 lastaddr = *lastaddrp;
609 bmask = ~(dmat->boundary - 1);
611 for (seg = *segp; buflen > 0 ; ) {
613 * Get the physical address for this segment.
616 curaddr = pmap_extract(pmap, vaddr);
618 curaddr = pmap_kextract(vaddr);
621 * Compute the segment size, and adjust counts.
623 sgsize = PAGE_SIZE - ((u_long)curaddr & PAGE_MASK);
628 * Make sure we don't cross any boundaries.
630 if (dmat->boundary > 0) {
631 baddr = (curaddr + dmat->boundary) & bmask;
632 if (sgsize > (baddr - curaddr))
633 sgsize = (baddr - curaddr);
637 * Insert chunk into a segment, coalescing with
638 * previous segment if possible.
641 segs[seg].ds_addr = curaddr;
642 segs[seg].ds_len = sgsize;
645 if (curaddr == lastaddr &&
646 (segs[seg].ds_len + sgsize) <= dmat->maxsegsz &&
647 (dmat->boundary == 0 ||
648 (segs[seg].ds_addr & bmask) == (curaddr & bmask)))
649 segs[seg].ds_len += sgsize;
651 if (++seg >= dmat->nsegments)
653 segs[seg].ds_addr = curaddr;
654 segs[seg].ds_len = sgsize;
658 lastaddr = curaddr + sgsize;
664 *lastaddrp = lastaddr;
669 return (buflen != 0 ? EFBIG : 0); /* XXX better return value here? */
673 * Like _bus_dmamap_load(), but for mbufs.
676 bus_dmamap_load_mbuf(bus_dma_tag_t dmat, bus_dmamap_t map,
678 bus_dmamap_callback2_t *callback, void *callback_arg,
683 KASSERT(dmat->lowaddr >= ptoa(Maxmem) || map != NULL,
684 ("bus_dmamap_load_mbuf: No support for bounce pages!"));
685 KASSERT(m0->m_flags & M_PKTHDR,
686 ("bus_dmamap_load_mbuf: no packet header"));
690 if (m0->m_pkthdr.len <= dmat->maxsize) {
692 vm_offset_t lastaddr = 0;
695 for (m = m0; m != NULL && error == 0; m = m->m_next) {
698 error = _bus_dmamap_load_buffer(dmat,
700 curthread, flags, &lastaddr,
709 /* force "no valid mappings" in callback */
710 (*callback)(callback_arg, dmat->segments, 0, 0, error);
712 (*callback)(callback_arg, dmat->segments,
713 nsegs+1, m0->m_pkthdr.len, error);
719 * Like _bus_dmamap_load(), but for uios.
722 bus_dmamap_load_uio(bus_dma_tag_t dmat, bus_dmamap_t map,
724 bus_dmamap_callback2_t *callback, void *callback_arg,
727 vm_offset_t lastaddr;
728 int nsegs, error, first, i;
731 struct thread *td = NULL;
733 KASSERT(dmat->lowaddr >= ptoa(Maxmem) || map != NULL,
734 ("bus_dmamap_load_uio: No support for bounce pages!"));
736 resid = uio->uio_resid;
739 if (uio->uio_segflg == UIO_USERSPACE) {
741 KASSERT(td != NULL && td->td_proc != NULL,
742 ("bus_dmamap_load_uio: USERSPACE but no proc"));
748 for (i = 0; i < uio->uio_iovcnt && resid != 0 && !error; i++) {
750 * Now at the first iovec to load. Load each iovec
751 * until we have exhausted the residual count.
754 resid < iov[i].iov_len ? resid : iov[i].iov_len;
755 caddr_t addr = (caddr_t) iov[i].iov_base;
757 error = _bus_dmamap_load_buffer(dmat,
759 td, flags, &lastaddr, &nsegs, first);
766 /* force "no valid mappings" in callback */
767 (*callback)(callback_arg, dmat->segments, 0, 0, error);
769 (*callback)(callback_arg, dmat->segments,
770 nsegs+1, uio->uio_resid, error);
776 * Release the mapping held by map.
779 _bus_dmamap_unload(bus_dma_tag_t dmat, bus_dmamap_t map)
781 struct bounce_page *bpage;
783 while ((bpage = STAILQ_FIRST(&map->bpages)) != NULL) {
784 STAILQ_REMOVE_HEAD(&map->bpages, links);
785 free_bounce_page(dmat, bpage);
790 _bus_dmamap_sync(bus_dma_tag_t dmat, bus_dmamap_t map, bus_dmasync_op_t op)
792 struct bounce_page *bpage;
794 if ((bpage = STAILQ_FIRST(&map->bpages)) != NULL) {
796 * Handle data bouncing. We might also
797 * want to add support for invalidating
798 * the caches on broken hardware
801 case BUS_DMASYNC_PREWRITE:
802 while (bpage != NULL) {
803 bcopy((void *)bpage->datavaddr,
804 (void *)bpage->vaddr,
806 bpage = STAILQ_NEXT(bpage, links);
810 case BUS_DMASYNC_POSTREAD:
811 while (bpage != NULL) {
812 bcopy((void *)bpage->vaddr,
813 (void *)bpage->datavaddr,
815 bpage = STAILQ_NEXT(bpage, links);
819 case BUS_DMASYNC_PREREAD:
820 case BUS_DMASYNC_POSTWRITE:
828 alloc_bounce_pages(bus_dma_tag_t dmat, u_int numpages)
833 if (total_bpages == 0) {
834 STAILQ_INIT(&bounce_page_list);
835 STAILQ_INIT(&bounce_map_waitinglist);
836 STAILQ_INIT(&bounce_map_callbacklist);
839 while (numpages > 0) {
840 struct bounce_page *bpage;
842 bpage = kmalloc(sizeof(*bpage), M_DEVBUF, M_INTWAIT | M_ZERO);
844 bpage->vaddr = (vm_offset_t)contigmalloc(PAGE_SIZE, M_DEVBUF,
849 if (bpage->vaddr == 0) {
850 kfree(bpage, M_DEVBUF);
853 bpage->busaddr = pmap_kextract(bpage->vaddr);
855 STAILQ_INSERT_TAIL(&bounce_page_list, bpage, links);
866 reserve_bounce_pages(bus_dma_tag_t dmat, bus_dmamap_t map)
870 pages = MIN(free_bpages, map->pagesneeded - map->pagesreserved);
871 free_bpages -= pages;
872 reserved_bpages += pages;
873 map->pagesreserved += pages;
874 pages = map->pagesneeded - map->pagesreserved;
880 add_bounce_page(bus_dma_tag_t dmat, bus_dmamap_t map, vm_offset_t vaddr,
883 struct bounce_page *bpage;
885 if (map->pagesneeded == 0)
886 panic("add_bounce_page: map doesn't need any pages");
889 if (map->pagesreserved == 0)
890 panic("add_bounce_page: map doesn't need any pages");
891 map->pagesreserved--;
894 bpage = STAILQ_FIRST(&bounce_page_list);
896 panic("add_bounce_page: free page list is empty");
898 STAILQ_REMOVE_HEAD(&bounce_page_list, links);
903 bpage->datavaddr = vaddr;
904 bpage->datacount = size;
905 STAILQ_INSERT_TAIL(&(map->bpages), bpage, links);
906 return (bpage->busaddr);
910 free_bounce_page(bus_dma_tag_t dmat, struct bounce_page *bpage)
912 struct bus_dmamap *map;
914 bpage->datavaddr = 0;
915 bpage->datacount = 0;
918 STAILQ_INSERT_HEAD(&bounce_page_list, bpage, links);
921 if ((map = STAILQ_FIRST(&bounce_map_waitinglist)) != NULL) {
922 if (reserve_bounce_pages(map->dmat, map) == 0) {
923 STAILQ_REMOVE_HEAD(&bounce_map_waitinglist, links);
924 STAILQ_INSERT_TAIL(&bounce_map_callbacklist,
926 busdma_swi_pending = 1;
936 struct bus_dmamap *map;
939 while ((map = STAILQ_FIRST(&bounce_map_callbacklist)) != NULL) {
940 STAILQ_REMOVE_HEAD(&bounce_map_callbacklist, links);
942 bus_dmamap_load(map->dmat, map, map->buf, map->buflen,
943 map->callback, map->callback_arg, /*flags*/0);