mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-10-03 15:47:36 +00:00
s390/zcrypt: remove incorrect kernel doc indicators
Many comments above functions start with a kernel doc indicator, but the comments are not using kernel doc style. Get rid of the warnings by simply removing the indicator. E.g.: drivers/s390/crypto/zcrypt_msgtype6.c:111: warning: This comment starts with '/**', but isn't a kernel-doc comment. Reviewed-by: Harald Freudenberger <freude@linux.ibm.com> Signed-off-by: Heiko Carstens <hca@linux.ibm.com>
This commit is contained in:
Heiko Carstens
parent
f6beebb15e
commit
2c57ad6024
6 changed files with 48 additions and 48 deletions
|
|
@ -71,7 +71,7 @@ static LIST_HEAD(zcrypt_ops_list);
|
|||
/* Zcrypt related debug feature stuff. */
|
||||
debug_info_t *zcrypt_dbf_info;
|
||||
|
||||
/**
|
||||
/*
|
||||
* Process a rescan of the transport layer.
|
||||
*
|
||||
* Returns 1, if the rescan has been processed, otherwise 0.
|
||||
|
|
@ -462,7 +462,7 @@ static void zcdn_destroy_all(void)
|
|||
|
||||
#endif
|
||||
|
||||
/**
|
||||
/*
|
||||
* zcrypt_read (): Not supported beyond zcrypt 1.3.1.
|
||||
*
|
||||
* This function is not supported beyond zcrypt 1.3.1.
|
||||
|
|
@ -473,7 +473,7 @@ static ssize_t zcrypt_read(struct file *filp, char __user *buf,
|
|||
return -EPERM;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* zcrypt_write(): Not allowed.
|
||||
*
|
||||
* Write is is not allowed
|
||||
|
|
@ -484,7 +484,7 @@ static ssize_t zcrypt_write(struct file *filp, const char __user *buf,
|
|||
return -EPERM;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* zcrypt_open(): Count number of users.
|
||||
*
|
||||
* Device open function to count number of users.
|
||||
|
|
@ -512,7 +512,7 @@ static int zcrypt_open(struct inode *inode, struct file *filp)
|
|||
return stream_open(inode, filp);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* zcrypt_release(): Count number of users.
|
||||
*
|
||||
* Device close function to count number of users.
|
||||
|
|
@ -2153,7 +2153,7 @@ static void zcdn_exit(void)
|
|||
|
||||
#endif
|
||||
|
||||
/**
|
||||
/*
|
||||
* zcrypt_api_init(): Module initialization.
|
||||
*
|
||||
* The module initialization code.
|
||||
|
|
@ -2191,7 +2191,7 @@ int __init zcrypt_api_init(void)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* zcrypt_api_exit(): Module termination.
|
||||
*
|
||||
* The module termination code.
|
||||
|
|
|
|||
|
|
@ -65,7 +65,7 @@ static struct ap_device_id zcrypt_cex2a_queue_ids[] = {
|
|||
|
||||
MODULE_DEVICE_TABLE(ap, zcrypt_cex2a_queue_ids);
|
||||
|
||||
/**
|
||||
/*
|
||||
* Probe function for CEX2A card devices. It always accepts the AP device
|
||||
* since the bus_match already checked the card type.
|
||||
* @ap_dev: pointer to the AP device.
|
||||
|
|
@ -124,7 +124,7 @@ static int zcrypt_cex2a_card_probe(struct ap_device *ap_dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This is called to remove the CEX2A card driver information
|
||||
* if an AP card device is removed.
|
||||
*/
|
||||
|
|
@ -142,7 +142,7 @@ static struct ap_driver zcrypt_cex2a_card_driver = {
|
|||
.flags = AP_DRIVER_FLAG_DEFAULT,
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* Probe function for CEX2A queue devices. It always accepts the AP device
|
||||
* since the bus_match already checked the queue type.
|
||||
* @ap_dev: pointer to the AP device.
|
||||
|
|
@ -183,7 +183,7 @@ static int zcrypt_cex2a_queue_probe(struct ap_device *ap_dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This is called to remove the CEX2A queue driver information
|
||||
* if an AP queue device is removed.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -171,7 +171,7 @@ static const struct attribute_group cca_queue_attr_grp = {
|
|||
.attrs = cca_queue_attrs,
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* Large random number detection function. Its sends a message to a CEX2C/CEX3C
|
||||
* card to find out if large random numbers are supported.
|
||||
* @ap_dev: pointer to the AP device.
|
||||
|
|
@ -237,7 +237,7 @@ static int zcrypt_cex2c_rng_supported(struct ap_queue *aq)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Probe function for CEX2C/CEX3C card devices. It always accepts the
|
||||
* AP device since the bus_match already checked the hardware type.
|
||||
* @ap_dev: pointer to the AP card device.
|
||||
|
|
@ -303,7 +303,7 @@ static int zcrypt_cex2c_card_probe(struct ap_device *ap_dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This is called to remove the CEX2C/CEX3C card driver information
|
||||
* if an AP card device is removed.
|
||||
*/
|
||||
|
|
@ -325,7 +325,7 @@ static struct ap_driver zcrypt_cex2c_card_driver = {
|
|||
.flags = AP_DRIVER_FLAG_DEFAULT,
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* Probe function for CEX2C/CEX3C queue devices. It always accepts the
|
||||
* AP device since the bus_match already checked the hardware type.
|
||||
* @ap_dev: pointer to the AP card device.
|
||||
|
|
@ -376,7 +376,7 @@ static int zcrypt_cex2c_queue_probe(struct ap_device *ap_dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This is called to remove the CEX2C/CEX3C queue driver information
|
||||
* if an AP queue device is removed.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -394,7 +394,7 @@ static const struct attribute_group ep11_queue_attr_grp = {
|
|||
.attrs = ep11_queue_attrs,
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* Probe function for CEX4/CEX5/CEX6/CEX7 card device. It always
|
||||
* accepts the AP device since the bus_match already checked
|
||||
* the hardware type.
|
||||
|
|
@ -562,7 +562,7 @@ static int zcrypt_cex4_card_probe(struct ap_device *ap_dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This is called to remove the CEX4/CEX5/CEX6/CEX7 card driver
|
||||
* information if an AP card device is removed.
|
||||
*/
|
||||
|
|
@ -586,7 +586,7 @@ static struct ap_driver zcrypt_cex4_card_driver = {
|
|||
.flags = AP_DRIVER_FLAG_DEFAULT,
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* Probe function for CEX4/CEX5/CEX6/CEX7 queue device. It always
|
||||
* accepts the AP device since the bus_match already checked
|
||||
* the hardware type.
|
||||
|
|
@ -652,7 +652,7 @@ static int zcrypt_cex4_queue_probe(struct ap_device *ap_dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This is called to remove the CEX4/CEX5/CEX6/CEX7 queue driver
|
||||
* information if an AP queue device is removed.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -39,7 +39,7 @@ MODULE_DESCRIPTION("Cryptographic Accelerator (message type 50), " \
|
|||
"Copyright IBM Corp. 2001, 2012");
|
||||
MODULE_LICENSE("GPL");
|
||||
|
||||
/**
|
||||
/*
|
||||
* The type 50 message family is associated with a CEXxA cards.
|
||||
*
|
||||
* The four members of the family are described below.
|
||||
|
|
@ -136,7 +136,7 @@ struct type50_crb3_msg {
|
|||
unsigned char message[512];
|
||||
} __packed;
|
||||
|
||||
/**
|
||||
/*
|
||||
* The type 80 response family is associated with a CEXxA cards.
|
||||
*
|
||||
* Note that all unsigned char arrays are right-justified and left-padded
|
||||
|
|
@ -188,7 +188,7 @@ unsigned int get_rsa_crt_fc(struct ica_rsa_modexpo_crt *crt, int *fcode)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Convert a ICAMEX message to a type50 MEX message.
|
||||
*
|
||||
* @zq: crypto queue pointer
|
||||
|
|
@ -255,7 +255,7 @@ static int ICAMEX_msg_to_type50MEX_msg(struct zcrypt_queue *zq,
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Convert a ICACRT message to a type50 CRT message.
|
||||
*
|
||||
* @zq: crypto queue pointer
|
||||
|
|
@ -346,7 +346,7 @@ static int ICACRT_msg_to_type50CRT_msg(struct zcrypt_queue *zq,
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Copy results from a type 80 reply message back to user space.
|
||||
*
|
||||
* @zq: crypto device pointer
|
||||
|
|
@ -418,7 +418,7 @@ static int convert_response_cex2a(struct zcrypt_queue *zq,
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This function is called from the AP bus code after a crypto request
|
||||
* "msg" has finished with the reply message "reply".
|
||||
* It is called from tasklet context.
|
||||
|
|
@ -457,7 +457,7 @@ static void zcrypt_cex2a_receive(struct ap_queue *aq,
|
|||
|
||||
static atomic_t zcrypt_step = ATOMIC_INIT(0);
|
||||
|
||||
/**
|
||||
/*
|
||||
* The request distributor calls this function if it picked the CEXxA
|
||||
* device to handle a modexpo request.
|
||||
* @zq: pointer to zcrypt_queue structure that identifies the
|
||||
|
|
@ -502,7 +502,7 @@ static long zcrypt_cex2a_modexpo(struct zcrypt_queue *zq,
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* The request distributor calls this function if it picked the CEXxA
|
||||
* device to handle a modexpo_crt request.
|
||||
* @zq: pointer to zcrypt_queue structure that identifies the
|
||||
|
|
@ -547,7 +547,7 @@ static long zcrypt_cex2a_modexpo_crt(struct zcrypt_queue *zq,
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* The crypto operations for message type 50.
|
||||
*/
|
||||
static struct zcrypt_ops zcrypt_msgtype50_ops = {
|
||||
|
|
|
|||
|
|
@ -44,7 +44,7 @@ MODULE_DESCRIPTION("Cryptographic Coprocessor (message type 6), " \
|
|||
"Copyright IBM Corp. 2001, 2012");
|
||||
MODULE_LICENSE("GPL");
|
||||
|
||||
/**
|
||||
/*
|
||||
* CPRB
|
||||
* Note that all shorts, ints and longs are little-endian.
|
||||
* All pointer fields are 32-bits long, and mean nothing
|
||||
|
|
@ -107,7 +107,7 @@ struct function_and_rules_block {
|
|||
unsigned char only_rule[8];
|
||||
} __packed;
|
||||
|
||||
/**
|
||||
/*
|
||||
* The following is used to initialize the CPRBX passed to the CEXxC/CEXxP
|
||||
* card in a type6 message. The 3 fields that must be filled in at execution
|
||||
* time are req_parml, rpl_parml and usage_domain.
|
||||
|
|
@ -236,7 +236,7 @@ int speed_idx_ep11(int req_type)
|
|||
}
|
||||
|
||||
|
||||
/**
|
||||
/*
|
||||
* Convert a ICAMEX message to a type6 MEX message.
|
||||
*
|
||||
* @zq: crypto device pointer
|
||||
|
|
@ -305,7 +305,7 @@ static int ICAMEX_msg_to_type6MEX_msgX(struct zcrypt_queue *zq,
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Convert a ICACRT message to a type6 CRT message.
|
||||
*
|
||||
* @zq: crypto device pointer
|
||||
|
|
@ -374,7 +374,7 @@ static int ICACRT_msg_to_type6CRT_msgX(struct zcrypt_queue *zq,
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Convert a XCRB message to a type6 CPRB message.
|
||||
*
|
||||
* @zq: crypto device pointer
|
||||
|
|
@ -571,7 +571,7 @@ static int xcrb_msg_to_type6_ep11cprb_msgx(bool userspace, struct ap_message *ap
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Copy results from a type 86 ICA reply message back to user space.
|
||||
*
|
||||
* @zq: crypto device pointer
|
||||
|
|
@ -697,7 +697,7 @@ static int convert_type86_ica(struct zcrypt_queue *zq,
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Copy results from a type 86 XCRB reply message back to user space.
|
||||
*
|
||||
* @zq: crypto device pointer
|
||||
|
|
@ -728,7 +728,7 @@ static int convert_type86_xcrb(bool userspace, struct zcrypt_queue *zq,
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Copy results from a type 86 EP11 XCRB reply message back to user space.
|
||||
*
|
||||
* @zq: crypto device pointer
|
||||
|
|
@ -911,7 +911,7 @@ static int convert_response_rng(struct zcrypt_queue *zq,
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This function is called from the AP bus code after a crypto request
|
||||
* "msg" has finished with the reply message "reply".
|
||||
* It is called from tasklet context.
|
||||
|
|
@ -966,7 +966,7 @@ static void zcrypt_msgtype6_receive(struct ap_queue *aq,
|
|||
complete(&(resp_type->work));
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* This function is called from the AP bus code after a crypto request
|
||||
* "msg" has finished with the reply message "reply".
|
||||
* It is called from tasklet context.
|
||||
|
|
@ -1015,7 +1015,7 @@ static void zcrypt_msgtype6_receive_ep11(struct ap_queue *aq,
|
|||
|
||||
static atomic_t zcrypt_step = ATOMIC_INIT(0);
|
||||
|
||||
/**
|
||||
/*
|
||||
* The request distributor calls this function if it picked the CEXxC
|
||||
* device to handle a modexpo request.
|
||||
* @zq: pointer to zcrypt_queue structure that identifies the
|
||||
|
|
@ -1063,7 +1063,7 @@ static long zcrypt_msgtype6_modexpo(struct zcrypt_queue *zq,
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* The request distributor calls this function if it picked the CEXxC
|
||||
* device to handle a modexpo_crt request.
|
||||
* @zq: pointer to zcrypt_queue structure that identifies the
|
||||
|
|
@ -1112,7 +1112,7 @@ static long zcrypt_msgtype6_modexpo_crt(struct zcrypt_queue *zq,
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Fetch function code from cprb.
|
||||
* Extracting the fc requires to copy the cprb from userspace.
|
||||
* So this function allocates memory and needs an ap_msg prepared
|
||||
|
|
@ -1140,7 +1140,7 @@ unsigned int get_cprb_fc(bool userspace, struct ica_xcRB *xcRB,
|
|||
return XCRB_msg_to_type6CPRB_msgX(userspace, ap_msg, xcRB, func_code, dom);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* The request distributor calls this function if it picked the CEXxC
|
||||
* device to handle a send_cprb request.
|
||||
* @zq: pointer to zcrypt_queue structure that identifies the
|
||||
|
|
@ -1170,7 +1170,7 @@ static long zcrypt_msgtype6_send_cprb(bool userspace, struct zcrypt_queue *zq,
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Fetch function code from ep11 cprb.
|
||||
* Extracting the fc requires to copy the ep11 cprb from userspace.
|
||||
* So this function allocates memory and needs an ap_msg prepared
|
||||
|
|
@ -1198,7 +1198,7 @@ unsigned int get_ep11cprb_fc(bool userspace, struct ep11_urb *xcrb,
|
|||
return xcrb_msg_to_type6_ep11cprb_msgx(userspace, ap_msg, xcrb, func_code);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* The request distributor calls this function if it picked the CEX4P
|
||||
* device to handle a send_ep11_cprb request.
|
||||
* @zq: pointer to zcrypt_queue structure that identifies the
|
||||
|
|
@ -1228,7 +1228,7 @@ static long zcrypt_msgtype6_send_ep11_cprb(bool userspace, struct zcrypt_queue *
|
|||
} __packed * payload_hdr = NULL;
|
||||
|
||||
|
||||
/**
|
||||
/*
|
||||
* The target domain field within the cprb body/payload block will be
|
||||
* replaced by the usage domain for non-management commands only.
|
||||
* Therefore we check the first bit of the 'flags' parameter for
|
||||
|
|
@ -1299,7 +1299,7 @@ unsigned int get_rng_fc(struct ap_message *ap_msg, int *func_code,
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* The request distributor calls this function if it picked the CEXxC
|
||||
* device to generate random data.
|
||||
* @zq: pointer to zcrypt_queue structure that identifies the
|
||||
|
|
@ -1339,7 +1339,7 @@ static long zcrypt_msgtype6_rng(struct zcrypt_queue *zq,
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* The crypto operations for a CEXxC card.
|
||||
*/
|
||||
static struct zcrypt_ops zcrypt_msgtype6_norng_ops = {
|
||||
|
|
|
|||
Loading…
Reference in a new issue