Annotation of qemu/target-arm/cpu.h, revision 1.1.1.7

1.1       root        1: /*
                      2:  * ARM virtual CPU header
1.1.1.5   root        3:  *
1.1       root        4:  *  Copyright (c) 2003 Fabrice Bellard
                      5:  *
                      6:  * This library is free software; you can redistribute it and/or
                      7:  * modify it under the terms of the GNU Lesser General Public
                      8:  * License as published by the Free Software Foundation; either
                      9:  * version 2 of the License, or (at your option) any later version.
                     10:  *
                     11:  * This library is distributed in the hope that it will be useful,
                     12:  * but WITHOUT ANY WARRANTY; without even the implied warranty of
                     13:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
                     14:  * Lesser General Public License for more details.
                     15:  *
                     16:  * You should have received a copy of the GNU Lesser General Public
1.1.1.7 ! root       17:  * License along with this library; if not, see <http://www.gnu.org/licenses/>.
1.1       root       18:  */
                     19: #ifndef CPU_ARM_H
                     20: #define CPU_ARM_H
                     21: 
                     22: #define TARGET_LONG_BITS 32
                     23: 
1.1.1.4   root       24: #define ELF_MACHINE    EM_ARM
                     25: 
1.1.1.7 ! root       26: #define CPUState struct CPUARMState
        !            27: 
1.1       root       28: #include "cpu-defs.h"
                     29: 
                     30: #include "softfloat.h"
                     31: 
                     32: #define TARGET_HAS_ICE 1
                     33: 
                     34: #define EXCP_UDEF            1   /* undefined instruction */
                     35: #define EXCP_SWI             2   /* software interrupt */
                     36: #define EXCP_PREFETCH_ABORT  3
                     37: #define EXCP_DATA_ABORT      4
1.1.1.2   root       38: #define EXCP_IRQ             5
                     39: #define EXCP_FIQ             6
1.1.1.3   root       40: #define EXCP_BKPT            7
1.1.1.5   root       41: #define EXCP_EXCEPTION_EXIT  8   /* Return from v7M exception.  */
1.1.1.6   root       42: #define EXCP_KERNEL_TRAP     9   /* Jumped to kernel code page.  */
1.1.1.5   root       43: 
                     44: #define ARMV7M_EXCP_RESET   1
                     45: #define ARMV7M_EXCP_NMI     2
                     46: #define ARMV7M_EXCP_HARD    3
                     47: #define ARMV7M_EXCP_MEM     4
                     48: #define ARMV7M_EXCP_BUS     5
                     49: #define ARMV7M_EXCP_USAGE   6
                     50: #define ARMV7M_EXCP_SVC     11
                     51: #define ARMV7M_EXCP_DEBUG   12
                     52: #define ARMV7M_EXCP_PENDSV  14
                     53: #define ARMV7M_EXCP_SYSTICK 15
                     54: 
                     55: typedef void ARMWriteCPFunc(void *opaque, int cp_info,
                     56:                             int srcreg, int operand, uint32_t value);
                     57: typedef uint32_t ARMReadCPFunc(void *opaque, int cp_info,
                     58:                                int dstreg, int operand);
                     59: 
1.1.1.6   root       60: struct arm_boot_info;
                     61: 
1.1.1.5   root       62: #define NB_MMU_MODES 2
1.1       root       63: 
                     64: /* We currently assume float and double are IEEE single and double
                     65:    precision respectively.
                     66:    Doing runtime conversions is tricky because VFP registers may contain
                     67:    integer values (eg. as the result of a FTOSI instruction).
                     68:    s<2n> maps to the least significant half of d<n>
                     69:    s<2n+1> maps to the most significant half of d<n>
                     70:  */
                     71: 
                     72: typedef struct CPUARMState {
1.1.1.2   root       73:     /* Regs for current mode.  */
1.1       root       74:     uint32_t regs[16];
1.1.1.2   root       75:     /* Frequently accessed CPSR bits are stored separately for efficiently.
1.1.1.4   root       76:        This contains all the other bits.  Use cpsr_{read,write} to access
1.1.1.2   root       77:        the whole CPSR.  */
                     78:     uint32_t uncached_cpsr;
                     79:     uint32_t spsr;
                     80: 
                     81:     /* Banked registers.  */
                     82:     uint32_t banked_spsr[6];
                     83:     uint32_t banked_r13[6];
                     84:     uint32_t banked_r14[6];
1.1.1.5   root       85: 
1.1.1.2   root       86:     /* These hold r8-r12.  */
                     87:     uint32_t usr_regs[5];
                     88:     uint32_t fiq_regs[5];
1.1.1.5   root       89: 
1.1       root       90:     /* cpsr flag cache for faster execution */
                     91:     uint32_t CF; /* 0 or 1 */
                     92:     uint32_t VF; /* V is the bit 31. All other bits are undefined */
1.1.1.6   root       93:     uint32_t NF; /* N is bit 31. All other bits are undefined.  */
                     94:     uint32_t ZF; /* Z set if zero.  */
1.1       root       95:     uint32_t QF; /* 0 or 1 */
1.1.1.5   root       96:     uint32_t GE; /* cpsr[19:16] */
1.1.1.6   root       97:     uint32_t thumb; /* cpsr[5]. 0 = arm mode, 1 = thumb mode. */
1.1.1.5   root       98:     uint32_t condexec_bits; /* IT bits.  cpsr[15:10,26:25].  */
1.1       root       99: 
1.1.1.2   root      100:     /* System control coprocessor (cp15) */
                    101:     struct {
1.1.1.3   root      102:         uint32_t c0_cpuid;
1.1.1.5   root      103:         uint32_t c0_cachetype;
1.1.1.6   root      104:         uint32_t c0_ccsid[16]; /* Cache size.  */
                    105:         uint32_t c0_clid; /* Cache level.  */
                    106:         uint32_t c0_cssel; /* Cache size selection.  */
1.1.1.5   root      107:         uint32_t c0_c1[8]; /* Feature registers.  */
                    108:         uint32_t c0_c2[8]; /* Instruction set registers.  */
1.1.1.2   root      109:         uint32_t c1_sys; /* System control register.  */
                    110:         uint32_t c1_coproc; /* Coprocessor access register.  */
1.1.1.5   root      111:         uint32_t c1_xscaleauxcr; /* XScale auxiliary control register.  */
                    112:         uint32_t c2_base0; /* MMU translation table base 0.  */
                    113:         uint32_t c2_base1; /* MMU translation table base 1.  */
1.1.1.6   root      114:         uint32_t c2_control; /* MMU translation table base control.  */
                    115:         uint32_t c2_mask; /* MMU translation table base selection mask.  */
                    116:         uint32_t c2_base_mask; /* MMU translation table base 0 mask. */
1.1.1.5   root      117:         uint32_t c2_data; /* MPU data cachable bits.  */
                    118:         uint32_t c2_insn; /* MPU instruction cachable bits.  */
                    119:         uint32_t c3; /* MMU domain access control register
                    120:                         MPU write buffer control.  */
1.1.1.2   root      121:         uint32_t c5_insn; /* Fault status registers.  */
                    122:         uint32_t c5_data;
1.1.1.5   root      123:         uint32_t c6_region[8]; /* MPU base/size registers.  */
1.1.1.2   root      124:         uint32_t c6_insn; /* Fault address registers.  */
                    125:         uint32_t c6_data;
                    126:         uint32_t c9_insn; /* Cache lockdown registers.  */
                    127:         uint32_t c9_data;
                    128:         uint32_t c13_fcse; /* FCSE PID.  */
                    129:         uint32_t c13_context; /* Context ID.  */
1.1.1.5   root      130:         uint32_t c13_tls1; /* User RW Thread register.  */
                    131:         uint32_t c13_tls2; /* User RO Thread register.  */
                    132:         uint32_t c13_tls3; /* Privileged Thread register.  */
                    133:         uint32_t c15_cpar; /* XScale Coprocessor Access Register */
                    134:         uint32_t c15_ticonfig; /* TI925T configuration byte.  */
                    135:         uint32_t c15_i_max; /* Maximum D-cache dirty line index.  */
                    136:         uint32_t c15_i_min; /* Minimum D-cache dirty line index.  */
                    137:         uint32_t c15_threadid; /* TI debugger thread-ID.  */
1.1.1.2   root      138:     } cp15;
1.1.1.3   root      139: 
1.1.1.5   root      140:     struct {
                    141:         uint32_t other_sp;
                    142:         uint32_t vecbase;
                    143:         uint32_t basepri;
                    144:         uint32_t control;
                    145:         int current_sp;
                    146:         int exception;
                    147:         int pending_exception;
                    148:         void *nvic;
                    149:     } v7m;
                    150: 
                    151:     /* Coprocessor IO used by peripherals */
                    152:     struct {
                    153:         ARMReadCPFunc *cp_read;
                    154:         ARMWriteCPFunc *cp_write;
                    155:         void *opaque;
                    156:     } cp[15];
                    157: 
1.1.1.6   root      158:     /* Thumb-2 EE state.  */
                    159:     uint32_t teecr;
                    160:     uint32_t teehbr;
                    161: 
1.1.1.3   root      162:     /* Internal CPU feature flags.  */
                    163:     uint32_t features;
                    164: 
1.1.1.5   root      165:     /* Callback for vectored interrupt controller.  */
                    166:     int (*get_irq_vector)(struct CPUARMState *);
                    167:     void *irq_opaque;
                    168: 
1.1       root      169:     /* VFP coprocessor state.  */
                    170:     struct {
1.1.1.5   root      171:         float64 regs[32];
1.1       root      172: 
1.1.1.3   root      173:         uint32_t xregs[16];
1.1       root      174:         /* We store these fpcsr fields separately for convenience.  */
                    175:         int vec_len;
                    176:         int vec_stride;
                    177: 
1.1.1.5   root      178:         /* scratch space when Tn are not sufficient.  */
                    179:         uint32_t scratch[8];
                    180: 
1.1       root      181:         float_status fp_status;
                    182:     } vfp;
1.1.1.5   root      183: #if defined(CONFIG_USER_ONLY)
                    184:     struct mmon_state *mmon_entry;
                    185: #else
                    186:     uint32_t mmon_addr;
                    187: #endif
                    188: 
                    189:     /* iwMMXt coprocessor state.  */
                    190:     struct {
                    191:         uint64_t regs[16];
                    192:         uint64_t val;
                    193: 
                    194:         uint32_t cregs[16];
                    195:     } iwmmxt;
1.1       root      196: 
1.1.1.3   root      197: #if defined(CONFIG_USER_ONLY)
                    198:     /* For usermode syscall translation.  */
                    199:     int eabi;
                    200: #endif
                    201: 
1.1.1.2   root      202:     CPU_COMMON
                    203: 
1.1.1.5   root      204:     /* These fields after the common ones so they are preserved on reset.  */
1.1.1.6   root      205:     struct arm_boot_info *boot_info;
1.1       root      206: } CPUARMState;
                    207: 
1.1.1.5   root      208: CPUARMState *cpu_arm_init(const char *cpu_model);
1.1.1.6   root      209: void arm_translate_init(void);
1.1       root      210: int cpu_arm_exec(CPUARMState *s);
                    211: void cpu_arm_close(CPUARMState *s);
1.1.1.2   root      212: void do_interrupt(CPUARMState *);
                    213: void switch_mode(CPUARMState *, int);
1.1.1.5   root      214: uint32_t do_arm_semihosting(CPUARMState *env);
1.1.1.2   root      215: 
1.1       root      216: /* you can call this signal handler from your SIGBUS and SIGSEGV
                    217:    signal handlers to inform the virtual CPU of exceptions. non zero
                    218:    is returned if the signal was handled by the virtual CPU.  */
1.1.1.5   root      219: int cpu_arm_signal_handler(int host_signum, void *pinfo,
1.1       root      220:                            void *puc);
1.1.1.6   root      221: int cpu_arm_handle_mmu_fault (CPUARMState *env, target_ulong address, int rw,
                    222:                               int mmu_idx, int is_softmuu);
1.1       root      223: 
1.1.1.5   root      224: void cpu_lock(void);
                    225: void cpu_unlock(void);
1.1.1.6   root      226: static inline void cpu_set_tls(CPUARMState *env, target_ulong newtls)
                    227: {
                    228:   env->cp15.c13_tls2 = newtls;
                    229: }
1.1.1.5   root      230: 
1.1.1.2   root      231: #define CPSR_M (0x1f)
                    232: #define CPSR_T (1 << 5)
                    233: #define CPSR_F (1 << 6)
                    234: #define CPSR_I (1 << 7)
                    235: #define CPSR_A (1 << 8)
                    236: #define CPSR_E (1 << 9)
                    237: #define CPSR_IT_2_7 (0xfc00)
1.1.1.5   root      238: #define CPSR_GE (0xf << 16)
                    239: #define CPSR_RESERVED (0xf << 20)
1.1.1.2   root      240: #define CPSR_J (1 << 24)
                    241: #define CPSR_IT_0_1 (3 << 25)
                    242: #define CPSR_Q (1 << 27)
1.1.1.5   root      243: #define CPSR_V (1 << 28)
                    244: #define CPSR_C (1 << 29)
                    245: #define CPSR_Z (1 << 30)
                    246: #define CPSR_N (1 << 31)
                    247: #define CPSR_NZCV (CPSR_N | CPSR_Z | CPSR_C | CPSR_V)
                    248: 
                    249: #define CPSR_IT (CPSR_IT_0_1 | CPSR_IT_2_7)
                    250: #define CACHED_CPSR_BITS (CPSR_T | CPSR_GE | CPSR_IT | CPSR_Q | CPSR_NZCV)
                    251: /* Bits writable in user mode.  */
                    252: #define CPSR_USER (CPSR_NZCV | CPSR_Q | CPSR_GE)
                    253: /* Execution state bits.  MRS read as zero, MSR writes ignored.  */
                    254: #define CPSR_EXEC (CPSR_T | CPSR_IT | CPSR_J)
1.1.1.2   root      255: 
                    256: /* Return the current CPSR value.  */
1.1.1.5   root      257: uint32_t cpsr_read(CPUARMState *env);
                    258: /* Set the CPSR.  Note that some bits of mask must be all-set or all-clear.  */
                    259: void cpsr_write(CPUARMState *env, uint32_t val, uint32_t mask);
                    260: 
                    261: /* Return the current xPSR value.  */
                    262: static inline uint32_t xpsr_read(CPUARMState *env)
1.1.1.2   root      263: {
                    264:     int ZF;
1.1.1.6   root      265:     ZF = (env->ZF == 0);
                    266:     return (env->NF & 0x80000000) | (ZF << 30)
1.1.1.5   root      267:         | (env->CF << 29) | ((env->VF & 0x80000000) >> 3) | (env->QF << 27)
                    268:         | (env->thumb << 24) | ((env->condexec_bits & 3) << 25)
                    269:         | ((env->condexec_bits & 0xfc) << 8)
                    270:         | env->v7m.exception;
1.1.1.2   root      271: }
                    272: 
1.1.1.5   root      273: /* Set the xPSR.  Note that some bits of mask must be all-set or all-clear.  */
                    274: static inline void xpsr_write(CPUARMState *env, uint32_t val, uint32_t mask)
1.1.1.2   root      275: {
                    276:     if (mask & CPSR_NZCV) {
1.1.1.6   root      277:         env->ZF = (~val) & CPSR_Z;
                    278:         env->NF = val;
1.1.1.2   root      279:         env->CF = (val >> 29) & 1;
                    280:         env->VF = (val << 3) & 0x80000000;
                    281:     }
                    282:     if (mask & CPSR_Q)
                    283:         env->QF = ((val & CPSR_Q) != 0);
1.1.1.5   root      284:     if (mask & (1 << 24))
                    285:         env->thumb = ((val & (1 << 24)) != 0);
                    286:     if (mask & CPSR_IT_0_1) {
                    287:         env->condexec_bits &= ~3;
                    288:         env->condexec_bits |= (val >> 25) & 3;
                    289:     }
                    290:     if (mask & CPSR_IT_2_7) {
                    291:         env->condexec_bits &= 3;
                    292:         env->condexec_bits |= (val >> 8) & 0xfc;
                    293:     }
                    294:     if (mask & 0x1ff) {
                    295:         env->v7m.exception = val & 0x1ff;
1.1.1.2   root      296:     }
                    297: }
                    298: 
                    299: enum arm_cpu_mode {
                    300:   ARM_CPU_MODE_USR = 0x10,
                    301:   ARM_CPU_MODE_FIQ = 0x11,
                    302:   ARM_CPU_MODE_IRQ = 0x12,
                    303:   ARM_CPU_MODE_SVC = 0x13,
                    304:   ARM_CPU_MODE_ABT = 0x17,
                    305:   ARM_CPU_MODE_UND = 0x1b,
                    306:   ARM_CPU_MODE_SYS = 0x1f
                    307: };
                    308: 
1.1.1.3   root      309: /* VFP system registers.  */
                    310: #define ARM_VFP_FPSID   0
                    311: #define ARM_VFP_FPSCR   1
1.1.1.5   root      312: #define ARM_VFP_MVFR1   6
                    313: #define ARM_VFP_MVFR0   7
1.1.1.3   root      314: #define ARM_VFP_FPEXC   8
                    315: #define ARM_VFP_FPINST  9
                    316: #define ARM_VFP_FPINST2 10
                    317: 
1.1.1.5   root      318: /* iwMMXt coprocessor control registers.  */
                    319: #define ARM_IWMMXT_wCID                0
                    320: #define ARM_IWMMXT_wCon                1
                    321: #define ARM_IWMMXT_wCSSF       2
                    322: #define ARM_IWMMXT_wCASF       3
                    323: #define ARM_IWMMXT_wCGR0       8
                    324: #define ARM_IWMMXT_wCGR1       9
                    325: #define ARM_IWMMXT_wCGR2       10
                    326: #define ARM_IWMMXT_wCGR3       11
1.1.1.3   root      327: 
                    328: enum arm_features {
                    329:     ARM_FEATURE_VFP,
1.1.1.5   root      330:     ARM_FEATURE_AUXCR,  /* ARM1026 Auxiliary control register.  */
                    331:     ARM_FEATURE_XSCALE, /* Intel XScale extensions.  */
                    332:     ARM_FEATURE_IWMMXT, /* Intel iwMMXt extension.  */
                    333:     ARM_FEATURE_V6,
                    334:     ARM_FEATURE_V6K,
                    335:     ARM_FEATURE_V7,
                    336:     ARM_FEATURE_THUMB2,
                    337:     ARM_FEATURE_MPU,    /* Only has Memory Protection Unit, not full MMU.  */
                    338:     ARM_FEATURE_VFP3,
                    339:     ARM_FEATURE_NEON,
                    340:     ARM_FEATURE_DIV,
                    341:     ARM_FEATURE_M, /* Microcontroller profile.  */
1.1.1.6   root      342:     ARM_FEATURE_OMAPCP, /* OMAP specific CP15 ops handling.  */
                    343:     ARM_FEATURE_THUMB2EE
1.1.1.3   root      344: };
                    345: 
                    346: static inline int arm_feature(CPUARMState *env, int feature)
                    347: {
                    348:     return (env->features & (1u << feature)) != 0;
                    349: }
                    350: 
1.1.1.5   root      351: void arm_cpu_list(FILE *f, int (*cpu_fprintf)(FILE *f, const char *fmt, ...));
1.1.1.3   root      352: 
1.1.1.5   root      353: /* Interface between CPU and Interrupt controller.  */
                    354: void armv7m_nvic_set_pending(void *opaque, int irq);
                    355: int armv7m_nvic_acknowledge_irq(void *opaque);
                    356: void armv7m_nvic_complete_irq(void *opaque, int irq);
                    357: 
                    358: void cpu_arm_set_cp_io(CPUARMState *env, int cpnum,
                    359:                        ARMReadCPFunc *cp_read, ARMWriteCPFunc *cp_write,
                    360:                        void *opaque);
                    361: 
                    362: /* Does the core conform to the the "MicroController" profile. e.g. Cortex-M3.
                    363:    Note the M in older cores (eg. ARM7TDMI) stands for Multiply. These are
                    364:    conventional cores (ie. Application or Realtime profile).  */
                    365: 
                    366: #define IS_M(env) arm_feature(env, ARM_FEATURE_M)
                    367: #define ARM_CPUID(env) (env->cp15.c0_cpuid)
                    368: 
                    369: #define ARM_CPUID_ARM1026     0x4106a262
                    370: #define ARM_CPUID_ARM926      0x41069265
                    371: #define ARM_CPUID_ARM946      0x41059461
                    372: #define ARM_CPUID_TI915T      0x54029152
                    373: #define ARM_CPUID_TI925T      0x54029252
                    374: #define ARM_CPUID_PXA250      0x69052100
                    375: #define ARM_CPUID_PXA255      0x69052d00
                    376: #define ARM_CPUID_PXA260      0x69052903
                    377: #define ARM_CPUID_PXA261      0x69052d05
                    378: #define ARM_CPUID_PXA262      0x69052d06
                    379: #define ARM_CPUID_PXA270      0x69054110
                    380: #define ARM_CPUID_PXA270_A0   0x69054110
                    381: #define ARM_CPUID_PXA270_A1   0x69054111
                    382: #define ARM_CPUID_PXA270_B0   0x69054112
                    383: #define ARM_CPUID_PXA270_B1   0x69054113
                    384: #define ARM_CPUID_PXA270_C0   0x69054114
                    385: #define ARM_CPUID_PXA270_C5   0x69054117
                    386: #define ARM_CPUID_ARM1136     0x4117b363
1.1.1.6   root      387: #define ARM_CPUID_ARM1136_R2  0x4107b362
1.1.1.5   root      388: #define ARM_CPUID_ARM11MPCORE 0x410fb022
                    389: #define ARM_CPUID_CORTEXA8    0x410fc080
                    390: #define ARM_CPUID_CORTEXM3    0x410fc231
                    391: #define ARM_CPUID_ANY         0xffffffff
1.1.1.3   root      392: 
1.1.1.2   root      393: #if defined(CONFIG_USER_ONLY)
1.1       root      394: #define TARGET_PAGE_BITS 12
1.1.1.2   root      395: #else
                    396: /* The ARM MMU allows 1k pages.  */
                    397: /* ??? Linux doesn't actually use these, and they're deprecated in recent
1.1.1.5   root      398:    architecture revisions.  Maybe a configure option to disable them.  */
1.1.1.2   root      399: #define TARGET_PAGE_BITS 10
                    400: #endif
1.1.1.5   root      401: 
                    402: #define cpu_init cpu_arm_init
                    403: #define cpu_exec cpu_arm_exec
                    404: #define cpu_gen_code cpu_arm_gen_code
                    405: #define cpu_signal_handler cpu_arm_signal_handler
                    406: #define cpu_list arm_cpu_list
                    407: 
1.1.1.6   root      408: #define CPU_SAVE_VERSION 1
1.1.1.5   root      409: 
                    410: /* MMU modes definitions */
                    411: #define MMU_MODE0_SUFFIX _kernel
                    412: #define MMU_MODE1_SUFFIX _user
                    413: #define MMU_USER_IDX 1
                    414: static inline int cpu_mmu_index (CPUState *env)
                    415: {
                    416:     return (env->uncached_cpsr & CPSR_M) == ARM_CPU_MODE_USR ? 1 : 0;
                    417: }
                    418: 
1.1.1.6   root      419: #if defined(CONFIG_USER_ONLY)
                    420: static inline void cpu_clone_regs(CPUState *env, target_ulong newsp)
                    421: {
                    422:     if (newsp)
                    423:         env->regs[13] = newsp;
                    424:     env->regs[0] = 0;
                    425: }
                    426: #endif
                    427: 
1.1       root      428: #include "cpu-all.h"
1.1.1.6   root      429: #include "exec-all.h"
                    430: 
                    431: static inline void cpu_pc_from_tb(CPUState *env, TranslationBlock *tb)
                    432: {
                    433:     env->regs[15] = tb->pc;
                    434: }
                    435: 
                    436: static inline void cpu_get_tb_cpu_state(CPUState *env, target_ulong *pc,
                    437:                                         target_ulong *cs_base, int *flags)
                    438: {
                    439:     *pc = env->regs[15];
                    440:     *cs_base = 0;
                    441:     *flags = env->thumb | (env->vfp.vec_len << 1)
                    442:             | (env->vfp.vec_stride << 4) | (env->condexec_bits << 8);
                    443:     if ((env->uncached_cpsr & CPSR_M) != ARM_CPU_MODE_USR)
                    444:         *flags |= (1 << 6);
                    445:     if (env->vfp.xregs[ARM_VFP_FPEXC] & (1 << 30))
                    446:         *flags |= (1 << 7);
                    447: }
1.1       root      448: 
                    449: #endif

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.