mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-11-15 00:04:15 +08:00
39986148bc
make C=1 reports the following kernel-doc warnings: fs/ubifs/compress.c:103: warning: Function parameter or struct member 'c' not described in 'ubifs_compress' fs/ubifs/compress.c:155: warning: Function parameter or struct member 'c' not described in 'ubifs_decompress' fs/ubifs/find.c:353: warning: Excess function parameter 'data' description in 'scan_for_free_cb' fs/ubifs/find.c:353: warning: Function parameter or struct member 'arg' not described in 'scan_for_free_cb' fs/ubifs/find.c:594: warning: Excess function parameter 'data' description in 'scan_for_idx_cb' fs/ubifs/find.c:594: warning: Function parameter or struct member 'arg' not described in 'scan_for_idx_cb' fs/ubifs/find.c:786: warning: Excess function parameter 'data' description in 'scan_dirty_idx_cb' fs/ubifs/find.c:786: warning: Function parameter or struct member 'arg' not described in 'scan_dirty_idx_cb' fs/ubifs/find.c:86: warning: Excess function parameter 'data' description in 'scan_for_dirty_cb' fs/ubifs/find.c:86: warning: Function parameter or struct member 'arg' not described in 'scan_for_dirty_cb' fs/ubifs/journal.c:369: warning: expecting prototype for wake_up_reservation(). Prototype was for add_or_start_queue() instead fs/ubifs/lprops.c:1018: warning: Excess function parameter 'lst' description in 'scan_check_cb' fs/ubifs/lprops.c:1018: warning: Function parameter or struct member 'arg' not described in 'scan_check_cb' fs/ubifs/lpt.c:1938: warning: Function parameter or struct member 'ptr' not described in 'lpt_scan_node' fs/ubifs/replay.c:60: warning: Function parameter or struct member 'hash' not described in 'replay_entry' Fix them. Signed-off-by: Jeff Johnson <quic_jjohnson@quicinc.com> Reviewed-by: Zhihao Cheng <chengzhihao1@huawei.com> Signed-off-by: Richard Weinberger <richard@nod.at>
265 lines
6.7 KiB
C
265 lines
6.7 KiB
C
// SPDX-License-Identifier: GPL-2.0-only
|
|
/*
|
|
* This file is part of UBIFS.
|
|
*
|
|
* Copyright (C) 2006-2008 Nokia Corporation.
|
|
* Copyright (C) 2006, 2007 University of Szeged, Hungary
|
|
*
|
|
* Authors: Adrian Hunter
|
|
* Artem Bityutskiy (Битюцкий Артём)
|
|
* Zoltan Sogor
|
|
*/
|
|
|
|
/*
|
|
* This file provides a single place to access to compression and
|
|
* decompression.
|
|
*/
|
|
|
|
#include <linux/crypto.h>
|
|
#include "ubifs.h"
|
|
|
|
/* Fake description object for the "none" compressor */
|
|
static struct ubifs_compressor none_compr = {
|
|
.compr_type = UBIFS_COMPR_NONE,
|
|
.name = "none",
|
|
.capi_name = "",
|
|
};
|
|
|
|
#ifdef CONFIG_UBIFS_FS_LZO
|
|
static DEFINE_MUTEX(lzo_mutex);
|
|
|
|
static struct ubifs_compressor lzo_compr = {
|
|
.compr_type = UBIFS_COMPR_LZO,
|
|
.comp_mutex = &lzo_mutex,
|
|
.name = "lzo",
|
|
.capi_name = "lzo",
|
|
};
|
|
#else
|
|
static struct ubifs_compressor lzo_compr = {
|
|
.compr_type = UBIFS_COMPR_LZO,
|
|
.name = "lzo",
|
|
};
|
|
#endif
|
|
|
|
#ifdef CONFIG_UBIFS_FS_ZLIB
|
|
static DEFINE_MUTEX(deflate_mutex);
|
|
static DEFINE_MUTEX(inflate_mutex);
|
|
|
|
static struct ubifs_compressor zlib_compr = {
|
|
.compr_type = UBIFS_COMPR_ZLIB,
|
|
.comp_mutex = &deflate_mutex,
|
|
.decomp_mutex = &inflate_mutex,
|
|
.name = "zlib",
|
|
.capi_name = "deflate",
|
|
};
|
|
#else
|
|
static struct ubifs_compressor zlib_compr = {
|
|
.compr_type = UBIFS_COMPR_ZLIB,
|
|
.name = "zlib",
|
|
};
|
|
#endif
|
|
|
|
#ifdef CONFIG_UBIFS_FS_ZSTD
|
|
static DEFINE_MUTEX(zstd_enc_mutex);
|
|
static DEFINE_MUTEX(zstd_dec_mutex);
|
|
|
|
static struct ubifs_compressor zstd_compr = {
|
|
.compr_type = UBIFS_COMPR_ZSTD,
|
|
.comp_mutex = &zstd_enc_mutex,
|
|
.decomp_mutex = &zstd_dec_mutex,
|
|
.name = "zstd",
|
|
.capi_name = "zstd",
|
|
};
|
|
#else
|
|
static struct ubifs_compressor zstd_compr = {
|
|
.compr_type = UBIFS_COMPR_ZSTD,
|
|
.name = "zstd",
|
|
};
|
|
#endif
|
|
|
|
/* All UBIFS compressors */
|
|
struct ubifs_compressor *ubifs_compressors[UBIFS_COMPR_TYPES_CNT];
|
|
|
|
/**
|
|
* ubifs_compress - compress data.
|
|
* @c: UBIFS file-system description object
|
|
* @in_buf: data to compress
|
|
* @in_len: length of the data to compress
|
|
* @out_buf: output buffer where compressed data should be stored
|
|
* @out_len: output buffer length is returned here
|
|
* @compr_type: type of compression to use on enter, actually used compression
|
|
* type on exit
|
|
*
|
|
* This function compresses input buffer @in_buf of length @in_len and stores
|
|
* the result in the output buffer @out_buf and the resulting length in
|
|
* @out_len. If the input buffer does not compress, it is just copied to the
|
|
* @out_buf. The same happens if @compr_type is %UBIFS_COMPR_NONE or if
|
|
* compression error occurred.
|
|
*
|
|
* Note, if the input buffer was not compressed, it is copied to the output
|
|
* buffer and %UBIFS_COMPR_NONE is returned in @compr_type.
|
|
*/
|
|
void ubifs_compress(const struct ubifs_info *c, const void *in_buf,
|
|
int in_len, void *out_buf, int *out_len, int *compr_type)
|
|
{
|
|
int err;
|
|
struct ubifs_compressor *compr = ubifs_compressors[*compr_type];
|
|
|
|
if (*compr_type == UBIFS_COMPR_NONE)
|
|
goto no_compr;
|
|
|
|
/* If the input data is small, do not even try to compress it */
|
|
if (in_len < UBIFS_MIN_COMPR_LEN)
|
|
goto no_compr;
|
|
|
|
if (compr->comp_mutex)
|
|
mutex_lock(compr->comp_mutex);
|
|
err = crypto_comp_compress(compr->cc, in_buf, in_len, out_buf,
|
|
(unsigned int *)out_len);
|
|
if (compr->comp_mutex)
|
|
mutex_unlock(compr->comp_mutex);
|
|
if (unlikely(err)) {
|
|
ubifs_warn(c, "cannot compress %d bytes, compressor %s, error %d, leave data uncompressed",
|
|
in_len, compr->name, err);
|
|
goto no_compr;
|
|
}
|
|
|
|
/*
|
|
* If the data compressed only slightly, it is better to leave it
|
|
* uncompressed to improve read speed.
|
|
*/
|
|
if (in_len - *out_len < UBIFS_MIN_COMPRESS_DIFF)
|
|
goto no_compr;
|
|
|
|
return;
|
|
|
|
no_compr:
|
|
memcpy(out_buf, in_buf, in_len);
|
|
*out_len = in_len;
|
|
*compr_type = UBIFS_COMPR_NONE;
|
|
}
|
|
|
|
/**
|
|
* ubifs_decompress - decompress data.
|
|
* @c: UBIFS file-system description object
|
|
* @in_buf: data to decompress
|
|
* @in_len: length of the data to decompress
|
|
* @out_buf: output buffer where decompressed data should
|
|
* @out_len: output length is returned here
|
|
* @compr_type: type of compression
|
|
*
|
|
* This function decompresses data from buffer @in_buf into buffer @out_buf.
|
|
* The length of the uncompressed data is returned in @out_len. This functions
|
|
* returns %0 on success or a negative error code on failure.
|
|
*/
|
|
int ubifs_decompress(const struct ubifs_info *c, const void *in_buf,
|
|
int in_len, void *out_buf, int *out_len, int compr_type)
|
|
{
|
|
int err;
|
|
struct ubifs_compressor *compr;
|
|
|
|
if (unlikely(compr_type < 0 || compr_type >= UBIFS_COMPR_TYPES_CNT)) {
|
|
ubifs_err(c, "invalid compression type %d", compr_type);
|
|
return -EINVAL;
|
|
}
|
|
|
|
compr = ubifs_compressors[compr_type];
|
|
|
|
if (unlikely(!compr->capi_name)) {
|
|
ubifs_err(c, "%s compression is not compiled in", compr->name);
|
|
return -EINVAL;
|
|
}
|
|
|
|
if (compr_type == UBIFS_COMPR_NONE) {
|
|
memcpy(out_buf, in_buf, in_len);
|
|
*out_len = in_len;
|
|
return 0;
|
|
}
|
|
|
|
if (compr->decomp_mutex)
|
|
mutex_lock(compr->decomp_mutex);
|
|
err = crypto_comp_decompress(compr->cc, in_buf, in_len, out_buf,
|
|
(unsigned int *)out_len);
|
|
if (compr->decomp_mutex)
|
|
mutex_unlock(compr->decomp_mutex);
|
|
if (err)
|
|
ubifs_err(c, "cannot decompress %d bytes, compressor %s, error %d",
|
|
in_len, compr->name, err);
|
|
|
|
return err;
|
|
}
|
|
|
|
/**
|
|
* compr_init - initialize a compressor.
|
|
* @compr: compressor description object
|
|
*
|
|
* This function initializes the requested compressor and returns zero in case
|
|
* of success or a negative error code in case of failure.
|
|
*/
|
|
static int __init compr_init(struct ubifs_compressor *compr)
|
|
{
|
|
if (compr->capi_name) {
|
|
compr->cc = crypto_alloc_comp(compr->capi_name, 0, 0);
|
|
if (IS_ERR(compr->cc)) {
|
|
pr_err("UBIFS error (pid %d): cannot initialize compressor %s, error %ld",
|
|
current->pid, compr->name, PTR_ERR(compr->cc));
|
|
return PTR_ERR(compr->cc);
|
|
}
|
|
}
|
|
|
|
ubifs_compressors[compr->compr_type] = compr;
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* compr_exit - de-initialize a compressor.
|
|
* @compr: compressor description object
|
|
*/
|
|
static void compr_exit(struct ubifs_compressor *compr)
|
|
{
|
|
if (compr->capi_name)
|
|
crypto_free_comp(compr->cc);
|
|
}
|
|
|
|
/**
|
|
* ubifs_compressors_init - initialize UBIFS compressors.
|
|
*
|
|
* This function initializes the compressor which were compiled in. Returns
|
|
* zero in case of success and a negative error code in case of failure.
|
|
*/
|
|
int __init ubifs_compressors_init(void)
|
|
{
|
|
int err;
|
|
|
|
err = compr_init(&lzo_compr);
|
|
if (err)
|
|
return err;
|
|
|
|
err = compr_init(&zstd_compr);
|
|
if (err)
|
|
goto out_lzo;
|
|
|
|
err = compr_init(&zlib_compr);
|
|
if (err)
|
|
goto out_zstd;
|
|
|
|
ubifs_compressors[UBIFS_COMPR_NONE] = &none_compr;
|
|
return 0;
|
|
|
|
out_zstd:
|
|
compr_exit(&zstd_compr);
|
|
out_lzo:
|
|
compr_exit(&lzo_compr);
|
|
return err;
|
|
}
|
|
|
|
/**
|
|
* ubifs_compressors_exit - de-initialize UBIFS compressors.
|
|
*/
|
|
void ubifs_compressors_exit(void)
|
|
{
|
|
compr_exit(&lzo_compr);
|
|
compr_exit(&zlib_compr);
|
|
compr_exit(&zstd_compr);
|
|
}
|