usr/src/uts/common/fs/zfs/sys/arc.h
author ahrens
Sat, 11 Nov 2006 09:04:24 -0800
changeset 3093 71525e4187d5
parent 2391 2fa3fd1db808
child 3290 256464cbb73c
permissions -rw-r--r--
6490569 verify arc bufs are not modified when they shouldn't be
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
     1
/*
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
     2
 * CDDL HEADER START
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
     3
 *
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
     4
 * The contents of this file are subject to the terms of the
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
     5
 * Common Development and Distribution License (the "License").
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
     6
 * You may not use this file except in compliance with the License.
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
     7
 *
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
     8
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
     9
 * or http://www.opensolaris.org/os/licensing.
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    10
 * See the License for the specific language governing permissions
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    11
 * and limitations under the License.
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    12
 *
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    13
 * When distributing Covered Code, include this CDDL HEADER in each
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    14
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    15
 * If applicable, add the following below this CDDL HEADER, with the
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    16
 * fields enclosed by brackets "[]" replaced with your own identifying
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    17
 * information: Portions Copyright [yyyy] [name of copyright owner]
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    18
 *
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    19
 * CDDL HEADER END
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    20
 */
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    21
/*
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    22
 * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    23
 * Use is subject to license terms.
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    24
 */
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    25
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    26
#ifndef	_SYS_ARC_H
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    27
#define	_SYS_ARC_H
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    28
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    29
#pragma ident	"%Z%%M%	%I%	%E% SMI"
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    30
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    31
#include <sys/zfs_context.h>
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    32
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    33
#ifdef	__cplusplus
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    34
extern "C" {
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    35
#endif
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    36
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    37
#include <sys/zio.h>
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    38
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    39
typedef struct arc_buf_hdr arc_buf_hdr_t;
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    40
typedef struct arc_buf arc_buf_t;
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    41
typedef void arc_done_func_t(zio_t *zio, arc_buf_t *buf, void *private);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    42
typedef void arc_byteswap_func_t(void *buf, size_t size);
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    43
typedef int arc_evict_func_t(void *private);
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    44
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    45
/* generic arc_done_func_t's which you can use */
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    46
arc_done_func_t arc_bcopy_func;
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    47
arc_done_func_t arc_getbuf_func;
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    48
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    49
struct arc_buf {
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    50
	arc_buf_hdr_t		*b_hdr;
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    51
	arc_buf_t		*b_next;
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    52
	void			*b_data;
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    53
	arc_evict_func_t	*b_efunc;
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    54
	void			*b_private;
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    55
};
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    56
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    57
/*
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    58
 * These are the flags we pass into calls to the arc
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    59
 */
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    60
#define	ARC_WAIT	(1 << 1)	/* perform I/O synchronously */
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    61
#define	ARC_NOWAIT	(1 << 2)	/* perform I/O asynchronously */
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    62
#define	ARC_PREFETCH	(1 << 3)	/* I/O is a prefetch */
2391
2fa3fd1db808 6447377 ZFS prefetch is inconsistant
maybee
parents: 1775
diff changeset
    63
#define	ARC_CACHED	(1 << 4)	/* I/O was already in cache */
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    64
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    65
arc_buf_t *arc_buf_alloc(spa_t *spa, int size, void *tag);
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    66
void arc_buf_add_ref(arc_buf_t *buf, void *tag);
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    67
int arc_buf_remove_ref(arc_buf_t *buf, void *tag);
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    68
int arc_buf_size(arc_buf_t *buf);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    69
void arc_release(arc_buf_t *buf, void *tag);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    70
int arc_released(arc_buf_t *buf);
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    71
int arc_has_callback(arc_buf_t *buf);
3093
71525e4187d5 6490569 verify arc bufs are not modified when they shouldn't be
ahrens
parents: 2391
diff changeset
    72
void arc_buf_freeze(arc_buf_t *buf);
71525e4187d5 6490569 verify arc bufs are not modified when they shouldn't be
ahrens
parents: 2391
diff changeset
    73
void arc_buf_thaw(arc_buf_t *buf);
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    74
#ifdef ZFS_DEBUG
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    75
int arc_referenced(arc_buf_t *buf);
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    76
#endif
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    77
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    78
int arc_read(zio_t *pio, spa_t *spa, blkptr_t *bp, arc_byteswap_func_t *swap,
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    79
    arc_done_func_t *done, void *private, int priority, int flags,
2391
2fa3fd1db808 6447377 ZFS prefetch is inconsistant
maybee
parents: 1775
diff changeset
    80
    uint32_t *arc_flags, zbookmark_t *zb);
1775
e51e26b432c0 6410698 ZFS metadata needs to be more highly replicated (ditto blocks)
billm
parents: 1544
diff changeset
    81
int arc_write(zio_t *pio, spa_t *spa, int checksum, int compress, int ncopies,
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    82
    uint64_t txg, blkptr_t *bp, arc_buf_t *buf,
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    83
    arc_done_func_t *done, void *private, int priority, int flags,
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    84
    uint32_t arc_flags, zbookmark_t *zb);
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    85
int arc_free(zio_t *pio, spa_t *spa, uint64_t txg, blkptr_t *bp,
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    86
    zio_done_func_t *done, void *private, uint32_t arc_flags);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    87
int arc_tryread(spa_t *spa, blkptr_t *bp, void *data);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    88
1544
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    89
void arc_set_callback(arc_buf_t *buf, arc_evict_func_t *func, void *private);
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    90
int arc_buf_evict(arc_buf_t *buf);
938876158511 PSARC 2006/077 zpool clear
eschrock
parents: 789
diff changeset
    91
789
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    92
void arc_flush(void);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    93
void arc_tempreserve_clear(uint64_t tempreserve);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    94
int arc_tempreserve_space(uint64_t tempreserve);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    95
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    96
void arc_init(void);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    97
void arc_fini(void);
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    98
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
    99
#ifdef	__cplusplus
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
   100
}
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
   101
#endif
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
   102
b348f31ed315 PSARC 2002/240 ZFS
ahrens
parents:
diff changeset
   103
#endif /* _SYS_ARC_H */