map_type¶
The directions data can move in an OpenMP map clause.
Declaration¶
Syntax¶
map_type
= To | From | ToFrom | Alloc | Release | Delete
Values¶
Value |
Meaning |
|---|---|
|
copy from the host to the device on entry. |
|
copy from the device to the host on exit. |
|
copy in on entry and out on exit. |
|
allocate on the device without copying anything in. |
|
decrement the device reference count on exit. |
|
remove the device copy unconditionally on exit. |
Return values¶
None.
Description¶
The default for a variable a target region uses is ToFrom; naming a
direction explicitly avoids a copy that is not needed, which is usually the
expensive part of running on a device.
Examples¶
An ASR text document that uses it:
(TranslationUnit
:symtab (SymbolTable
:id 0
:symbols {
"main" (Program
:symtab (SymbolTable
:id 1
:symbols {
"a" (Variable
:parent_symtab 1
:name "a"
:dependencies []
:intent :Local
:symbolic_value nil
:value nil
:storage :Default
:type (Array
:type (Integer
:kind 4
)
:dims [
(dimension
:start (IntegerConstant
:n 1
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
:length (IntegerConstant
:n 3
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
)
]
:physical_type :FixedSizeArray
)
:type_declaration nil
:abi :Source
:access :Public
:presence :Required
:value_attr false
:target_attr false
:contiguous_attr false
:bindc_name nil
:is_volatile false
:is_protected false
:pass_attr :NotMethod
:self_argument nil
:codims []
)
"i" (Variable
:parent_symtab 1
:name "i"
:dependencies []
:intent :Local
:symbolic_value nil
:value nil
:storage :Default
:type (Integer
:kind 4
)
:type_declaration nil
:abi :Source
:access :Public
:presence :Required
:value_attr false
:target_attr false
:contiguous_attr false
:bindc_name nil
:is_volatile false
:is_protected false
:pass_attr :NotMethod
:self_argument nil
:codims []
)
"n" (Variable
:parent_symtab 1
:name "n"
:dependencies []
:intent :Local
:symbolic_value nil
:value nil
:storage :Default
:type (Integer
:kind 4
)
:type_declaration nil
:abi :Source
:access :Public
:presence :Required
:value_attr false
:target_attr false
:contiguous_attr false
:bindc_name nil
:is_volatile false
:is_protected false
:pass_attr :NotMethod
:self_argument nil
:codims []
)
"run" (Variable
:parent_symtab 1
:name "run"
:dependencies []
:intent :Local
:symbolic_value nil
:value nil
:storage :Default
:type (Logical
:kind 4
)
:type_declaration nil
:abi :Source
:access :Public
:presence :Required
:value_attr false
:target_attr false
:contiguous_attr false
:bindc_name nil
:is_volatile false
:is_protected false
:pass_attr :NotMethod
:self_argument nil
:codims []
)
"total" (Variable
:parent_symtab 1
:name "total"
:dependencies []
:intent :Local
:symbolic_value nil
:value nil
:storage :Default
:type (Integer
:kind 4
)
:type_declaration nil
:abi :Source
:access :Public
:presence :Required
:value_attr false
:target_attr false
:contiguous_attr false
:bindc_name nil
:is_volatile false
:is_protected false
:pass_attr :NotMethod
:self_argument nil
:codims []
)
}
)
:name "main"
:dependencies []
:body [
(OMPRegion
:region :Parallel
:clauses [
(OMPPrivate
:vars [
(Var
:v (SymbolRef 1 "i")
)
]
)
(OMPShared
:vars [
(Var
:v (SymbolRef 1 "a")
)
]
)
(OMPFirstPrivate
:vars [
(Var
:v (SymbolRef 1 "n")
)
]
)
(OMPNumThreads
:num_threads (IntegerConstant
:n 4
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
)
(OMPIf
:condition (Var
:v (SymbolRef 1 "run")
)
)
]
:body [
(OMPRegion
:region :Do
:clauses [
(OMPSchedule
:kind :Static
:chunk_size (IntegerConstant
:n 1
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
)
(OMPCollapse
:count (IntegerConstant
:n 1
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
)
(OMPReduction
:operator :ReduceAdd
:vars [
(Var
:v (SymbolRef 1 "total")
)
]
)
(OMPLastPrivate
:vars [
(Var
:v (SymbolRef 1 "i")
)
]
)
(OMPNowait)
]
:body [
(DoLoop
:name nil
:head (do_loop_head
:v (Var
:v (SymbolRef 1 "i")
)
:start (IntegerConstant
:n 1
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
:end (IntegerConstant
:n 3
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
:increment (IntegerConstant
:n 1
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
)
:body [
(Assignment
:target (Var
:v (SymbolRef 1 "total")
)
:value (IntegerBinOp
:left (Var
:v (SymbolRef 1 "total")
)
:op :Add
:right (Var
:v (SymbolRef 1 "i")
)
:type (Integer
:kind 4
)
:value nil
)
:overloaded nil
:realloc_lhs false
:move_allocation false
)
]
:orelse []
)
]
)
]
)
(OMPRegion
:region :Target
:clauses [
(OMPMap
:type :ToFrom
:vars [
(Var
:v (SymbolRef 1 "a")
)
]
)
(OMPDevice
:device (IntegerConstant
:n 0
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
)
]
:body [
(OMPRegion
:region :Teams
:clauses [
(OMPNumTeams
:num_teams (IntegerConstant
:n 2
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
)
(OMPThreadLimit
:thread_limit (IntegerConstant
:n 64
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
)
]
:body [
(Assignment
:target (Var
:v (SymbolRef 1 "total")
)
:value (IntegerConstant
:n 0
:type (Integer
:kind 4
)
:intboz_type :Decimal
)
:overloaded nil
:realloc_lhs false
:move_allocation false
)
]
)
]
)
]
)
}
)
:items []
)