build: cleanup src/target directory
[openocd.git] / src / target / target.h
index 12726bd71b3353e414b947726938b5a546d26f33..680f8c32b27c3b18a191cdac52578985922bb001 100644 (file)
@@ -29,6 +29,7 @@
  *   Free Software Foundation, Inc.,                                       *
  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  ***************************************************************************/
+
 #ifndef TARGET_H
 #define TARGET_H
 
@@ -57,8 +58,7 @@ struct target_list;
  */
 
 
-enum target_state
-{
+enum target_state {
        TARGET_UNKNOWN = 0,
        TARGET_RUNNING = 1,
        TARGET_HALTED = 2,
@@ -71,16 +71,14 @@ enum nvp_assert {
        NVP_ASSERT,
 };
 
-enum target_reset_mode
-{
+enum target_reset_mode {
        RESET_UNKNOWN = 0,
        RESET_RUN = 1,          /* reset and let target run */
        RESET_HALT = 2,         /* reset and halt target out of reset */
        RESET_INIT = 3,         /* reset and halt target out of reset, then run init script */
 };
 
-enum target_debug_reason
-{
+enum target_debug_reason {
        DBG_REASON_DBGRQ = 0,
        DBG_REASON_BREAKPOINT = 1,
        DBG_REASON_WATCHPOINT = 2,
@@ -90,14 +88,12 @@ enum target_debug_reason
        DBG_REASON_UNDEFINED = 6
 };
 
-enum target_endianness
-{
+enum target_endianness {
        TARGET_ENDIAN_UNKNOWN = 0,
        TARGET_BIG_ENDIAN = 1, TARGET_LITTLE_ENDIAN = 2
 };
 
-struct working_area
-{
+struct working_area {
        uint32_t address;
        uint32_t size;
        bool free;
@@ -105,26 +101,23 @@ struct working_area
        struct working_area **user;
        struct working_area *next;
 };
-struct gdb_service
-{
+
+struct gdb_service {
        struct target *target;
        /*  field for smp display  */
        /*  element 0 coreid currently displayed ( 1 till n) */
-    /*  element 1 coreid to be displayed at next resume 1 till n 0 means resume
-        *  all cores
-         core displayed  */
+       /*  element 1 coreid to be displayed at next resume 1 till n 0 means resume
+        *  all cores core displayed  */
        int32_t core[2];
 };
 
-// target_type.h contains the full definitionof struct targe_type
-struct target
-{
-       struct target_type *type;                               /* target type definition (name, access functions) */
+/* target_type.h contains the full definitionof struct targe_type */
+struct target {
+       struct target_type *type;                       /* target type definition (name, access functions) */
        const char *cmd_name;                           /* tcl Name of target */
        int target_number;                                      /* DO NOT USE!  field to be removed in 2010 */
-       struct jtag_tap *tap;                                   /* where on the jtag chain is this */
-       int32_t coreid;                                                 /* which device on the TAP? */
+       struct jtag_tap *tap;                           /* where on the jtag chain is this */
+       int32_t coreid;                                         /* which device on the TAP? */
        const char *variant;                            /* what variant of this chip is it? */
 
        /**
@@ -146,25 +139,25 @@ struct target
        struct target_event_action *event_action;
 
        int reset_halt;                                         /* attempt resetting the CPU into the halted mode? */
-       uint32_t working_area;                                  /* working area (initialized RAM). Evaluated
+       uint32_t working_area;                          /* working area (initialized RAM). Evaluated
                                                                                 * upon first allocation from virtual/physical address. */
        bool working_area_virt_spec;            /* virtual address specified? */
        uint32_t working_area_virt;                     /* virtual address */
        bool working_area_phys_spec;            /* virtual address specified? */
        uint32_t working_area_phys;                     /* physical address */
        uint32_t working_area_size;                     /* size in bytes */
-       uint32_t backup_working_area;                   /* whether the content of the working area has to be preserved */
+       uint32_t backup_working_area;           /* whether the content of the working area has to be preserved */
        struct working_area *working_areas;/* list of allocated working areas */
        enum target_debug_reason debug_reason;/* reason why the target entered debug state */
        enum target_endianness endianness;      /* target endianness */
-       // also see: target_state_name()
+       /* also see: target_state_name() */
        enum target_state state;                        /* the current backend-state (running, halted, ...) */
        struct reg_cache *reg_cache;            /* the first register cache of the target (core regs) */
-       struct breakpoint *breakpoints; /* list of breakpoints */
-       struct watchpoint *watchpoints; /* list of watchpoints */
+       struct breakpoint *breakpoints;         /* list of breakpoints */
+       struct watchpoint *watchpoints;         /* list of watchpoints */
        struct trace *trace_info;                       /* generic trace information */
-       struct debug_msg_receiver *dbgmsg;/* list of debug message receivers */
-       uint32_t dbg_msg_enabled;                               /* debug message status */
+       struct debug_msg_receiver *dbgmsg;      /* list of debug message receivers */
+       uint32_t dbg_msg_enabled;                       /* debug message status */
        void *arch_info;                                        /* architecture specific information */
        struct target *next;                            /* next target in list */
 
@@ -175,13 +168,13 @@ struct target
 
        bool dbgbase_set;                                       /* By default the debug base is not set */
        uint32_t dbgbase;                                       /* Really a Cortex-A specific option, but there is no
-                                                                                  system in place to support target specific options
-                                                                                  currently. */
+                                                                                       system in place to support target specific options
+                                                                                       currently. */
        struct rtos *rtos;                                      /* Instance of Real Time Operating System support */
-       bool rtos_auto_detect;                          /* A flag that indicates that the RTOS has been specified as "auto" 
-                                            * and must be detected when symbols are offered */
+       bool rtos_auto_detect;                          /* A flag that indicates that the RTOS has been specified as "auto"
+                                                                                * and must be detected when symbols are offered */
 
-       int smp;                                                                /*  add some target attributes for smp support */
+       int smp;                                                        /*  add some target attributes for smp support */
        struct target_list *head;
        /*  the gdb service is there in case of smp , we have only one gdb server
         *  for all smp target
@@ -190,7 +183,6 @@ struct target
        struct gdb_service *gdb_service;
 };
 
-
 struct target_list {
        struct target *target;
        struct target_list *next;
@@ -204,8 +196,7 @@ static inline const char *target_name(struct target *target)
 
 const char *debug_reason_name(struct target *t);
 
-enum target_event
-{
+enum target_event {
        /* LD historical names
         * - Prior to the great TCL change
         * - June/July/Aug 2008
@@ -269,15 +260,13 @@ struct target_event_action {
 
 bool target_has_event_action(struct target *target, enum target_event event);
 
-struct target_event_callback
-{
+struct target_event_callback {
        int (*callback)(struct target *target, enum target_event event, void *priv);
        void *priv;
        struct target_event_callback *next;
 };
 
-struct target_timer_callback
-{
+struct target_timer_callback {
        int (*callback)(void *priv);
        int time_ms;
        int periodic;
@@ -291,11 +280,11 @@ int target_examine(void);
 
 int target_register_event_callback(
                int (*callback)(struct target *target,
-                               enum target_event event, void *priv),
+               enum target_event event, void *priv),
                void *priv);
 int target_unregister_event_callback(
                int (*callback)(struct target *target,
-                               enum target_event event, void *priv),
+               enum target_event event, void *priv),
                void *priv);
 /* Poll the status of the target, detect any error conditions and report them.
  *
@@ -329,7 +318,7 @@ int target_call_timer_callbacks(void);
  */
 int target_call_timer_callbacks_now(void);
 
-struct targetget_current_target(struct command_context *cmd_ctx);
+struct target *get_current_target(struct command_context *cmd_ctx);
 struct target *get_target(const char *id);
 
 /**
@@ -348,14 +337,14 @@ const char *target_type_name(struct target *target);
  */
 int target_examine_one(struct target *target);
 
-/// @returns @c true if target_set_examined() has been called.
+/** @returns @c true if target_set_examined() has been called. */
 static inline bool target_was_examined(struct target *target)
 {
        return target->examined;
 }
 
-/// Sets the @c examined flag for the given target.
-/// Use in target->type->examine() after one-time setup is done.
+/** Sets the @c examined flag for the given target. */
+/** Use in target->type->examine() after one-time setup is done. */
 static inline void target_set_examined(struct target *target)
 {
        target->examined = true;
@@ -520,13 +509,13 @@ int target_write_buffer(struct target *target,
 int target_read_buffer(struct target *target,
                uint32_t address, uint32_t size, uint8_t *buffer);
 int target_checksum_memory(struct target *target,
-               uint32_t address, uint32_t size, uint32_tcrc);
+               uint32_t address, uint32_t size, uint32_t *crc);
 int target_blank_check_memory(struct target *target,
-               uint32_t address, uint32_t size, uint32_tblank);
+               uint32_t address, uint32_t size, uint32_t *blank);
 int target_wait_state(struct target *target, enum target_state state, int ms);
 
 /** Return the *name* of this targets current state */
-const char *target_state_name( struct target *target );
+const char *target_state_name(struct target *target);
 
 /* DANGER!!!!!
  *

Linking to existing account procedure

If you already have an account and want to add another login method you MUST first sign in with your existing account and then change URL to read https://review.openocd.org/login/?link to get to this page again but this time it'll work for linking. Thank you.

SSH host keys fingerprints

1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=..              |
|+o..   .         |
|*.o   . .        |
|+B . . .         |
|Bo. = o S        |
|Oo.+ + =         |
|oB=.* = . o      |
| =+=.+   + E     |
|. .=o   . o      |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)