cregit-Linux how code gets into the kernel

Release 4.11 drivers/net/ethernet/mellanox/mlx5/core/fs_cmd.c

/*
 * Copyright (c) 2015, Mellanox Technologies. All rights reserved.
 *
 * This software is available to you under a choice of one of two
 * licenses.  You may choose to be licensed under the terms of the GNU
 * General Public License (GPL) Version 2, available from the file
 * COPYING in the main directory of this source tree, or the
 * OpenIB.org BSD license below:
 *
 *     Redistribution and use in source and binary forms, with or
 *     without modification, are permitted provided that the following
 *     conditions are met:
 *
 *      - Redistributions of source code must retain the above
 *        copyright notice, this list of conditions and the following
 *        disclaimer.
 *
 *      - Redistributions in binary form must reproduce the above
 *        copyright notice, this list of conditions and the following
 *        disclaimer in the documentation and/or other materials
 *        provided with the distribution.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

#include <linux/mlx5/driver.h>
#include <linux/mlx5/device.h>
#include <linux/mlx5/mlx5_ifc.h>

#include "fs_core.h"
#include "fs_cmd.h"
#include "mlx5_core.h"
#include "eswitch.h"


int mlx5_cmd_update_root_ft(struct mlx5_core_dev *dev, struct mlx5_flow_table *ft) { u32 in[MLX5_ST_SZ_DW(set_flow_table_root_in)] = {0}; u32 out[MLX5_ST_SZ_DW(set_flow_table_root_out)] = {0}; MLX5_SET(set_flow_table_root_in, in, opcode, MLX5_CMD_OP_SET_FLOW_TABLE_ROOT); MLX5_SET(set_flow_table_root_in, in, table_type, ft->type); MLX5_SET(set_flow_table_root_in, in, table_id, ft->id); if (ft->vport) { MLX5_SET(set_flow_table_root_in, in, vport_number, ft->vport); MLX5_SET(set_flow_table_root_in, in, other_vport, 1); } return mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb8968.46%133.33%
Mohamad Haj Yahia3224.62%133.33%
Saeed Mahameed96.92%133.33%
Total130100.00%3100.00%


int mlx5_cmd_create_flow_table(struct mlx5_core_dev *dev, u16 vport, enum fs_flow_table_op_mod op_mod, enum fs_flow_table_type type, unsigned int level, unsigned int log_size, struct mlx5_flow_table *next_ft, unsigned int *table_id, u32 flags) { int en_encap_decap = !!(flags & MLX5_FLOW_TABLE_TUNNEL_EN); u32 out[MLX5_ST_SZ_DW(create_flow_table_out)] = {0}; u32 in[MLX5_ST_SZ_DW(create_flow_table_in)] = {0}; int err; MLX5_SET(create_flow_table_in, in, opcode, MLX5_CMD_OP_CREATE_FLOW_TABLE); MLX5_SET(create_flow_table_in, in, table_type, type); MLX5_SET(create_flow_table_in, in, level, level); MLX5_SET(create_flow_table_in, in, log_size, log_size); if (vport) { MLX5_SET(create_flow_table_in, in, vport_number, vport); MLX5_SET(create_flow_table_in, in, other_vport, 1); } MLX5_SET(create_flow_table_in, in, decap_en, en_encap_decap); MLX5_SET(create_flow_table_in, in, encap_en, en_encap_decap); switch (op_mod) { case FS_FT_OP_MOD_NORMAL: if (next_ft) { MLX5_SET(create_flow_table_in, in, table_miss_mode, 1); MLX5_SET(create_flow_table_in, in, table_miss_id, next_ft->id); } break; case FS_FT_OP_MOD_LAG_DEMUX: MLX5_SET(create_flow_table_in, in, op_mod, 0x1); if (next_ft) MLX5_SET(create_flow_table_in, in, lag_master_next_table_id, next_ft->id); break; } err = mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); if (!err) *table_id = MLX5_GET(create_flow_table_out, out, table_id); return err; }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb14951.56%233.33%
Aviv Heller6923.88%116.67%
Hadar Hen Zion3612.46%116.67%
Mohamad Haj Yahia269.00%116.67%
Saeed Mahameed93.11%116.67%
Total289100.00%6100.00%


int mlx5_cmd_destroy_flow_table(struct mlx5_core_dev *dev, struct mlx5_flow_table *ft) { u32 in[MLX5_ST_SZ_DW(destroy_flow_table_in)] = {0}; u32 out[MLX5_ST_SZ_DW(destroy_flow_table_out)] = {0}; MLX5_SET(destroy_flow_table_in, in, opcode, MLX5_CMD_OP_DESTROY_FLOW_TABLE); MLX5_SET(destroy_flow_table_in, in, table_type, ft->type); MLX5_SET(destroy_flow_table_in, in, table_id, ft->id); if (ft->vport) { MLX5_SET(destroy_flow_table_in, in, vport_number, ft->vport); MLX5_SET(destroy_flow_table_in, in, other_vport, 1); } return mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb8968.46%250.00%
Mohamad Haj Yahia3224.62%125.00%
Saeed Mahameed96.92%125.00%
Total130100.00%4100.00%


int mlx5_cmd_modify_flow_table(struct mlx5_core_dev *dev, struct mlx5_flow_table *ft, struct mlx5_flow_table *next_ft) { u32 in[MLX5_ST_SZ_DW(modify_flow_table_in)] = {0}; u32 out[MLX5_ST_SZ_DW(modify_flow_table_out)] = {0}; MLX5_SET(modify_flow_table_in, in, opcode, MLX5_CMD_OP_MODIFY_FLOW_TABLE); MLX5_SET(modify_flow_table_in, in, table_type, ft->type); MLX5_SET(modify_flow_table_in, in, table_id, ft->id); if (ft->op_mod == FS_FT_OP_MOD_LAG_DEMUX) { MLX5_SET(modify_flow_table_in, in, modify_field_select, MLX5_MODIFY_FLOW_TABLE_LAG_NEXT_TABLE_ID); if (next_ft) { MLX5_SET(modify_flow_table_in, in, lag_master_next_table_id, next_ft->id); } else { MLX5_SET(modify_flow_table_in, in, lag_master_next_table_id, 0); } } else { if (ft->vport) { MLX5_SET(modify_flow_table_in, in, vport_number, ft->vport); MLX5_SET(modify_flow_table_in, in, other_vport, 1); } MLX5_SET(modify_flow_table_in, in, modify_field_select, MLX5_MODIFY_FLOW_TABLE_MISS_TABLE_ID); if (next_ft) { MLX5_SET(modify_flow_table_in, in, table_miss_mode, 1); MLX5_SET(modify_flow_table_in, in, table_miss_id, next_ft->id); } else { MLX5_SET(modify_flow_table_in, in, table_miss_mode, 0); } } return mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb14960.32%240.00%
Aviv Heller5723.08%120.00%
Mohamad Haj Yahia3212.96%120.00%
Saeed Mahameed93.64%120.00%
Total247100.00%5100.00%


int mlx5_cmd_create_flow_group(struct mlx5_core_dev *dev, struct mlx5_flow_table *ft, u32 *in, unsigned int *group_id) { u32 out[MLX5_ST_SZ_DW(create_flow_group_out)] = {0}; int inlen = MLX5_ST_SZ_BYTES(create_flow_group_in); int err; MLX5_SET(create_flow_group_in, in, opcode, MLX5_CMD_OP_CREATE_FLOW_GROUP); MLX5_SET(create_flow_group_in, in, table_type, ft->type); MLX5_SET(create_flow_group_in, in, table_id, ft->id); if (ft->vport) { MLX5_SET(create_flow_group_in, in, vport_number, ft->vport); MLX5_SET(create_flow_group_in, in, other_vport, 1); } err = mlx5_cmd_exec(dev, in, inlen, out, sizeof(out)); if (!err) *group_id = MLX5_GET(create_flow_group_out, out, group_id); return err; }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb11070.97%133.33%
Mohamad Haj Yahia3220.65%133.33%
Saeed Mahameed138.39%133.33%
Total155100.00%3100.00%


int mlx5_cmd_destroy_flow_group(struct mlx5_core_dev *dev, struct mlx5_flow_table *ft, unsigned int group_id) { u32 out[MLX5_ST_SZ_DW(destroy_flow_group_out)] = {0}; u32 in[MLX5_ST_SZ_DW(destroy_flow_group_in)] = {0}; MLX5_SET(destroy_flow_group_in, in, opcode, MLX5_CMD_OP_DESTROY_FLOW_GROUP); MLX5_SET(destroy_flow_group_in, in, table_type, ft->type); MLX5_SET(destroy_flow_group_in, in, table_id, ft->id); MLX5_SET(destroy_flow_group_in, in, group_id, group_id); if (ft->vport) { MLX5_SET(destroy_flow_group_in, in, vport_number, ft->vport); MLX5_SET(destroy_flow_group_in, in, other_vport, 1); } return mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb10471.72%133.33%
Mohamad Haj Yahia3222.07%133.33%
Saeed Mahameed96.21%133.33%
Total145100.00%3100.00%


static int mlx5_cmd_set_fte(struct mlx5_core_dev *dev, int opmod, int modify_mask, struct mlx5_flow_table *ft, unsigned group_id, struct fs_fte *fte) { unsigned int inlen = MLX5_ST_SZ_BYTES(set_fte_in) + fte->dests_size * MLX5_ST_SZ_BYTES(dest_format_struct); u32 out[MLX5_ST_SZ_DW(set_fte_out)] = {0}; struct mlx5_flow_rule *dst; void *in_flow_context; void *in_match_value; void *in_dests; u32 *in; int err; in = mlx5_vzalloc(inlen); if (!in) { mlx5_core_warn(dev, "failed to allocate inbox\n"); return -ENOMEM; } MLX5_SET(set_fte_in, in, opcode, MLX5_CMD_OP_SET_FLOW_TABLE_ENTRY); MLX5_SET(set_fte_in, in, op_mod, opmod); MLX5_SET(set_fte_in, in, modify_enable_mask, modify_mask); MLX5_SET(set_fte_in, in, table_type, ft->type); MLX5_SET(set_fte_in, in, table_id, ft->id); MLX5_SET(set_fte_in, in, flow_index, fte->index); if (ft->vport) { MLX5_SET(set_fte_in, in, vport_number, ft->vport); MLX5_SET(set_fte_in, in, other_vport, 1); } in_flow_context = MLX5_ADDR_OF(set_fte_in, in, flow_context); MLX5_SET(flow_context, in_flow_context, group_id, group_id); MLX5_SET(flow_context, in_flow_context, flow_tag, fte->flow_tag); MLX5_SET(flow_context, in_flow_context, action, fte->action); MLX5_SET(flow_context, in_flow_context, encap_id, fte->encap_id); in_match_value = MLX5_ADDR_OF(flow_context, in_flow_context, match_value); memcpy(in_match_value, &fte->val, MLX5_ST_SZ_BYTES(fte_match_param)); in_dests = MLX5_ADDR_OF(flow_context, in_flow_context, destination); if (fte->action & MLX5_FLOW_CONTEXT_ACTION_FWD_DEST) { int list_size = 0; list_for_each_entry(dst, &fte->node.children, node.list) { unsigned int id; if (dst->dest_attr.type == MLX5_FLOW_DESTINATION_TYPE_COUNTER) continue; MLX5_SET(dest_format_struct, in_dests, destination_type, dst->dest_attr.type); if (dst->dest_attr.type == MLX5_FLOW_DESTINATION_TYPE_FLOW_TABLE) { id = dst->dest_attr.ft->id; } else { id = dst->dest_attr.tir_num; } MLX5_SET(dest_format_struct, in_dests, destination_id, id); in_dests += MLX5_ST_SZ_BYTES(dest_format_struct); list_size++; } MLX5_SET(flow_context, in_flow_context, destination_list_size, list_size); } if (fte->action & MLX5_FLOW_CONTEXT_ACTION_COUNT) { int list_size = 0; list_for_each_entry(dst, &fte->node.children, node.list) { if (dst->dest_attr.type != MLX5_FLOW_DESTINATION_TYPE_COUNTER) continue; MLX5_SET(flow_counter_list, in_dests, flow_counter_id, dst->dest_attr.counter->id); in_dests += MLX5_ST_SZ_BYTES(dest_format_struct); list_size++; } MLX5_SET(flow_context, in_flow_context, flow_counter_list_size, list_size); } err = mlx5_cmd_exec(dev, in, inlen, out, sizeof(out)); kvfree(in); return err; }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb36468.42%116.67%
Amir Vadai11822.18%233.33%
Mohamad Haj Yahia326.02%116.67%
Hadar Hen Zion132.44%116.67%
Saeed Mahameed50.94%116.67%
Total532100.00%6100.00%


int mlx5_cmd_create_fte(struct mlx5_core_dev *dev, struct mlx5_flow_table *ft, unsigned group_id, struct fs_fte *fte) { return mlx5_cmd_set_fte(dev, 0, 0, ft, group_id, fte); }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb39100.00%1100.00%
Total39100.00%1100.00%


int mlx5_cmd_update_fte(struct mlx5_core_dev *dev, struct mlx5_flow_table *ft, unsigned group_id, int modify_mask, struct fs_fte *fte) { int opmod; int atomic_mod_cap = MLX5_CAP_FLOWTABLE(dev, flow_table_properties_nic_receive. flow_modify_en); if (!atomic_mod_cap) return -EOPNOTSUPP; opmod = 1; return mlx5_cmd_set_fte(dev, opmod, modify_mask, ft, group_id, fte); }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb6694.29%133.33%
Amir Vadai34.29%133.33%
Or Gerlitz11.43%133.33%
Total70100.00%3100.00%


int mlx5_cmd_delete_fte(struct mlx5_core_dev *dev, struct mlx5_flow_table *ft, unsigned int index) { u32 out[MLX5_ST_SZ_DW(delete_fte_out)] = {0}; u32 in[MLX5_ST_SZ_DW(delete_fte_in)] = {0}; MLX5_SET(delete_fte_in, in, opcode, MLX5_CMD_OP_DELETE_FLOW_TABLE_ENTRY); MLX5_SET(delete_fte_in, in, table_type, ft->type); MLX5_SET(delete_fte_in, in, table_id, ft->id); MLX5_SET(delete_fte_in, in, flow_index, index); if (ft->vport) { MLX5_SET(delete_fte_in, in, vport_number, ft->vport); MLX5_SET(delete_fte_in, in, other_vport, 1); } return mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); }

Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb10371.03%133.33%
Mohamad Haj Yahia3222.07%133.33%
Saeed Mahameed106.90%133.33%
Total145100.00%3100.00%


int mlx5_cmd_fc_alloc(struct mlx5_core_dev *dev, u16 *id) { u32 in[MLX5_ST_SZ_DW(alloc_flow_counter_in)] = {0}; u32 out[MLX5_ST_SZ_DW(alloc_flow_counter_out)] = {0}; int err; MLX5_SET(alloc_flow_counter_in, in, opcode, MLX5_CMD_OP_ALLOC_FLOW_COUNTER); err = mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); if (!err) *id = MLX5_GET(alloc_flow_counter_out, out, flow_counter_id); return err; }

Contributors

PersonTokensPropCommitsCommitProp
Amir Vadai8488.42%150.00%
Saeed Mahameed1111.58%150.00%
Total95100.00%2100.00%


int mlx5_cmd_fc_free(struct mlx5_core_dev *dev, u16 id) { u32 in[MLX5_ST_SZ_DW(dealloc_flow_counter_in)] = {0}; u32 out[MLX5_ST_SZ_DW(dealloc_flow_counter_out)] = {0}; MLX5_SET(dealloc_flow_counter_in, in, opcode, MLX5_CMD_OP_DEALLOC_FLOW_COUNTER); MLX5_SET(dealloc_flow_counter_in, in, flow_counter_id, id); return mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); }

Contributors

PersonTokensPropCommitsCommitProp
Amir Vadai7288.89%150.00%
Saeed Mahameed911.11%150.00%
Total81100.00%2100.00%


int mlx5_cmd_fc_query(struct mlx5_core_dev *dev, u16 id, u64 *packets, u64 *bytes) { u32 out[MLX5_ST_SZ_BYTES(query_flow_counter_out) + MLX5_ST_SZ_BYTES(traffic_counter)] = {0}; u32 in[MLX5_ST_SZ_DW(query_flow_counter_in)] = {0}; void *stats; int err = 0; MLX5_SET(query_flow_counter_in, in, opcode, MLX5_CMD_OP_QUERY_FLOW_COUNTER); MLX5_SET(query_flow_counter_in, in, op_mod, 0); MLX5_SET(query_flow_counter_in, in, flow_counter_id, id); err = mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); if (err) return err; stats = MLX5_ADDR_OF(query_flow_counter_out, out, flow_statistics); *packets = MLX5_GET64(traffic_counter, stats, packets); *bytes = MLX5_GET64(traffic_counter, stats, octets); return 0; }

Contributors

PersonTokensPropCommitsCommitProp
Amir Vadai15194.38%150.00%
Saeed Mahameed95.62%150.00%
Total160100.00%2100.00%

struct mlx5_cmd_fc_bulk { u16 id; int num; int outlen; u32 out[0]; };
struct mlx5_cmd_fc_bulk * mlx5_cmd_fc_bulk_alloc(struct mlx5_core_dev *dev, u16 id, int num) { struct mlx5_cmd_fc_bulk *b; int outlen = MLX5_ST_SZ_BYTES(query_flow_counter_out) + MLX5_ST_SZ_BYTES(traffic_counter) * num; b = kzalloc(sizeof(*b) + outlen, GFP_KERNEL); if (!b) return NULL; b->id = id; b->num = num; b->outlen = outlen; return b; }

Contributors

PersonTokensPropCommitsCommitProp
Amir Vadai7692.68%150.00%
Roi Dayan67.32%150.00%
Total82100.00%2100.00%


void mlx5_cmd_fc_bulk_free(struct mlx5_cmd_fc_bulk *b) { kfree(b); }

Contributors

PersonTokensPropCommitsCommitProp
Amir Vadai15100.00%1100.00%
Total15100.00%1100.00%


int mlx5_cmd_fc_bulk_query(struct mlx5_core_dev *dev, struct mlx5_cmd_fc_bulk *b) { u32 in[MLX5_ST_SZ_DW(query_flow_counter_in)] = {0}; MLX5_SET(query_flow_counter_in, in, opcode, MLX5_CMD_OP_QUERY_FLOW_COUNTER); MLX5_SET(query_flow_counter_in, in, op_mod, 0); MLX5_SET(query_flow_counter_in, in, flow_counter_id, b->id); MLX5_SET(query_flow_counter_in, in, num_of_counters, b->num); return mlx5_cmd_exec(dev, in, sizeof(in), b->out, b->outlen); }

Contributors

PersonTokensPropCommitsCommitProp
Amir Vadai9294.85%150.00%
Saeed Mahameed55.15%150.00%
Total97100.00%2100.00%


void mlx5_cmd_fc_bulk_get(struct mlx5_core_dev *dev, struct mlx5_cmd_fc_bulk *b, u16 id, u64 *packets, u64 *bytes) { int index = id - b->id; void *stats; if (index < 0 || index >= b->num) { mlx5_core_warn(dev, "Flow counter id (0x%x) out of range (0x%x..0x%x). Counter ignored.\n", id, b->id, b->id + b->num - 1); return; } stats = MLX5_ADDR_OF(query_flow_counter_out, b->out, flow_statistics[index]); *packets = MLX5_GET64(traffic_counter, stats, packets); *bytes = MLX5_GET64(traffic_counter, stats, octets); }

Contributors

PersonTokensPropCommitsCommitProp
Amir Vadai117100.00%1100.00%
Total117100.00%1100.00%


int mlx5_encap_alloc(struct mlx5_core_dev *dev, int header_type, size_t size, void *encap_header, u32 *encap_id) { int max_encap_size = MLX5_CAP_ESW(dev, max_encap_header_size); u32 out[MLX5_ST_SZ_DW(alloc_encap_header_out)]; void *encap_header_in; void *header; int inlen; int err; u32 *in; if (size > max_encap_size) { mlx5_core_warn(dev, "encap size %zd too big, max supported is %d\n", size, max_encap_size); return -EINVAL; } in = kzalloc(MLX5_ST_SZ_BYTES(alloc_encap_header_in) + size, GFP_KERNEL); if (!in) return -ENOMEM; encap_header_in = MLX5_ADDR_OF(alloc_encap_header_in, in, encap_header); header = MLX5_ADDR_OF(encap_header_in, encap_header_in, encap_header); inlen = header - (void *)in + size; memset(in, 0, inlen); MLX5_SET(alloc_encap_header_in, in, opcode, MLX5_CMD_OP_ALLOC_ENCAP_HEADER); MLX5_SET(encap_header_in, encap_header_in, encap_header_size, size); MLX5_SET(encap_header_in, encap_header_in, header_type, header_type); memcpy(header, encap_header, size); memset(out, 0, sizeof(out)); err = mlx5_cmd_exec(dev, in, inlen, out, sizeof(out)); *encap_id = MLX5_GET(alloc_encap_header_out, out, encap_id); kfree(in); return err; }

Contributors

PersonTokensPropCommitsCommitProp
Ilya Lesokhin16367.36%125.00%
Hadar Hen Zion6727.69%250.00%
Or Gerlitz124.96%125.00%
Total242100.00%4100.00%


void mlx5_encap_dealloc(struct mlx5_core_dev *dev, u32 encap_id) { u32 in[MLX5_ST_SZ_DW(dealloc_encap_header_in)]; u32 out[MLX5_ST_SZ_DW(dealloc_encap_header_out)]; memset(in, 0, sizeof(in)); MLX5_SET(dealloc_encap_header_in, in, opcode, MLX5_CMD_OP_DEALLOC_ENCAP_HEADER); MLX5_SET(dealloc_encap_header_in, in, encap_id, encap_id); mlx5_cmd_exec(dev, in, sizeof(in), out, sizeof(out)); }

Contributors

PersonTokensPropCommitsCommitProp
Ilya Lesokhin8398.81%150.00%
Hadar Hen Zion11.19%150.00%
Total84100.00%2100.00%


Overall Contributors

PersonTokensPropCommitsCommitProp
Maor Gottlieb128144.22%421.05%
Amir Vadai74825.82%421.05%
Mohamad Haj Yahia2508.63%15.26%
Ilya Lesokhin2468.49%15.26%
Aviv Heller1264.35%15.26%
Hadar Hen Zion1204.14%421.05%
Saeed Mahameed1073.69%15.26%
Or Gerlitz130.45%210.53%
Roi Dayan60.21%15.26%
Total2897100.00%19100.00%
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
Created with cregit.