Commit 2c57ad60 authored by Heiko Carstens's avatar Heiko Carstens
Browse files

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: default avatarHarald Freudenberger <freude@linux.ibm.com>
Signed-off-by: default avatarHeiko Carstens <hca@linux.ibm.com>
parent f6beebb1

drivers/s390/crypto/zcrypt_api.c

+7 −7
Original line number Diff line number Diff line
@@ -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.

drivers/s390/crypto/zcrypt_cex2a.c

+4 −4
Original line number Diff line number Diff line
@@ -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.

 */

drivers/s390/crypto/zcrypt_cex2c.c

+5 −5
Original line number Diff line number Diff line
@@ -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.

 */

drivers/s390/crypto/zcrypt_cex4.c

+4 −4
Original line number Diff line number Diff line
@@ -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.

 */

drivers/s390/crypto/zcrypt_msgtype50.c

+9 −9
Original line number Diff line number Diff line
@@ -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 = {