block: drbd: drbd_main: Fix a bunch of function documentation discrepancies (584164c8) · Commits · EulixOS / Software / Kernel

drivers/block/drbd/drbd_main.c

+15 −14

Original line number	Diff line number	Diff line
		@@ -268,7 +268,7 @@ void tl_restart(struct drbd_connection *connection, enum drbd_req_event what)

		/**
		* tl_clear() - Clears all requests and &struct drbd_tl_epoch objects out of the TL
		* @device: DRBD device.
		* @connection: DRBD connection.
		*
		* This is called after the connection to the peer was lost. The storage covered
		* by the requests on the transfer gets marked as our of sync. Called from the
		@@ -479,7 +479,7 @@ int conn_lowest_minor(struct drbd_connection *connection)
		}

		#ifdef CONFIG_SMP
		/**
		/*
		* drbd_calc_cpu_mask() - Generate CPU masks, spread over all CPUs
		*
		* Forces all threads of a resource onto the same CPU. This is beneficial for
		@@ -518,7 +518,6 @@ static void drbd_calc_cpu_mask(cpumask_var_t *cpu_mask)

		/**
		* drbd_thread_current_set_cpu() - modifies the cpu mask of the _current_ thread
		* @device: DRBD device.
		* @thi: drbd_thread object
		*
		* call in the "main loop" of _all_ threads, no need for any mutex, current won't die
		@@ -538,7 +537,7 @@ void drbd_thread_current_set_cpu(struct drbd_thread *thi)
		#define drbd_calc_cpu_mask(A) ({})
		#endif

		/**
		/*
		* drbd_header_size - size of a packet header
		*
		* The header size is a multiple of 8, so any payload following the header is
		@@ -1193,7 +1192,7 @@ static int fill_bitmap_rle_bits(struct drbd_device *device,
		return len;
		}

		/**
		/*
		* send_bitmap_rle_or_plain
		*
		* Return 0 when done, 1 when another iteration is needed, and a negative error
		@@ -1324,7 +1323,7 @@ void drbd_send_b_ack(struct drbd_connection *connection, u32 barrier_nr, u32 set

		/**
		* _drbd_send_ack() - Sends an ack packet
		* @device: DRBD device.
		* @peer_device: DRBD peer device.
		* @cmd: Packet command code.
		* @sector: sector, needs to be in big endian byte order
		* @blksize: size in byte, needs to be in big endian byte order
		@@ -1370,7 +1369,7 @@ void drbd_send_ack_rp(struct drbd_peer_device *peer_device, enum drbd_packet cmd

		/**
		* drbd_send_ack() - Sends an ack packet
		* @device: DRBD device
		* @peer_device: DRBD peer device
		* @cmd: packet command code
		* @peer_req: peer request
		*/
		@@ -1882,7 +1881,7 @@ int drbd_send(struct drbd_connection connection, struct socket sock,
		return sent;
		}

		/**
		/*
		* drbd_send_all - Send an entire buffer
		*
		* Returns 0 upon success and a negative error value otherwise.
		@@ -3509,6 +3508,7 @@ static int w_bitmap_io(struct drbd_work *w, int unused)
		* @io_fn: IO callback to be called when bitmap IO is possible
		* @done: callback to be called after the bitmap IO was performed
		* @why: Descriptive text of the reason for doing the IO
		* @flags: Bitmap flags
		*
		* While IO on the bitmap happens we freeze application IO thus we ensure
		* that drbd_set_out_of_sync() can not be called. This function MAY ONLY be
		@@ -3554,6 +3554,7 @@ void drbd_queue_bitmap_io(struct drbd_device *device,
		* @device: DRBD device.
		* @io_fn: IO callback to be called when bitmap IO is possible
		* @why: Descriptive text of the reason for doing the IO
		* @flags: Bitmap flags
		*
		* freezes application IO while that the actual IO operations runs. This
		* functions MAY NOT be called from worker context.