diff options
author | Karel Zak | 2012-12-04 11:58:13 +0100 |
---|---|---|
committer | Karel Zak | 2012-12-04 12:08:53 +0100 |
commit | 2e31fe2303e4938ef735aebf13aa5b22fb031af9 (patch) | |
tree | 4dff61f83c3f5fb55aa62619e1cc0f85b8558a08 /libblkid | |
parent | fdisk: move DOS units stuff to fdiskdoslabel.c (diff) | |
download | kernel-qcow2-util-linux-2e31fe2303e4938ef735aebf13aa5b22fb031af9.tar.gz kernel-qcow2-util-linux-2e31fe2303e4938ef735aebf13aa5b22fb031af9.tar.xz kernel-qcow2-util-linux-2e31fe2303e4938ef735aebf13aa5b22fb031af9.zip |
libblkid: cleanup nonnull attribute usage
- don't mix __attribute__((nonnull)) and "if (!argument) return" for
the same function. The "if ()" check will be *silently* optimized
out by gcc.
- use __attribute__((nonnull)) for functions where is impossible to
return error code. For example "is" and "has" functions or functions
where we return unsigned types and zero is a valid value.
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'libblkid')
-rw-r--r-- | libblkid/src/blkid.h.in | 170 |
1 files changed, 52 insertions, 118 deletions
diff --git a/libblkid/src/blkid.h.in b/libblkid/src/blkid.h.in index 717c71d3f..a41bd99d0 100644 --- a/libblkid/src/blkid.h.in +++ b/libblkid/src/blkid.h.in @@ -138,27 +138,20 @@ typedef struct blkid_struct_dev_iterate *blkid_dev_iterate; #endif /* cache.c */ -extern void blkid_put_cache(blkid_cache cache) - __ul_attribute__((nonnull)); -extern int blkid_get_cache(blkid_cache *cache, const char *filename) - __ul_attribute__((nonnull(1))); -extern void blkid_gc_cache(blkid_cache cache) - __ul_attribute__((nonnull)); +extern void blkid_put_cache(blkid_cache cache); +extern int blkid_get_cache(blkid_cache *cache, const char *filename); +extern void blkid_gc_cache(blkid_cache cache); /* dev.c */ extern const char *blkid_dev_devname(blkid_dev dev) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_dev_iterate blkid_dev_iterate_begin(blkid_cache cache) __ul_attribute__((nonnull)); extern int blkid_dev_set_search(blkid_dev_iterate iter, - char *search_type, char *search_value) - __ul_attribute__((nonnull)); -extern int blkid_dev_next(blkid_dev_iterate iterate, blkid_dev *dev) - __ul_attribute__((nonnull)); -extern void blkid_dev_iterate_end(blkid_dev_iterate iterate) - __ul_attribute__((nonnull)); + char *search_type, char *search_value); +extern int blkid_dev_next(blkid_dev_iterate iterate, blkid_dev *dev); +extern void blkid_dev_iterate_end(blkid_dev_iterate iterate); /* devno.c */ extern char *blkid_devno_to_devname(dev_t devno) @@ -168,134 +161,109 @@ extern int blkid_devno_to_wholedisk(dev_t dev, char *diskname, __ul_attribute__((warn_unused_result)); /* devname.c */ -extern int blkid_probe_all(blkid_cache cache) - __ul_attribute__((nonnull)); -extern int blkid_probe_all_new(blkid_cache cache) - __ul_attribute__((nonnull)); -extern int blkid_probe_all_removable(blkid_cache cache) - __ul_attribute__((nonnull)); -extern blkid_dev blkid_get_dev(blkid_cache cache, const char *devname, - int flags) - __ul_attribute__((nonnull)); +extern int blkid_probe_all(blkid_cache cache); +extern int blkid_probe_all_new(blkid_cache cache); +extern int blkid_probe_all_removable(blkid_cache cache); + +extern blkid_dev blkid_get_dev(blkid_cache cache, const char *devname, int flags); /* getsize.c */ extern blkid_loff_t blkid_get_dev_size(int fd) __ul_attribute__((warn_unused_result)); /* verify.c */ -extern blkid_dev blkid_verify(blkid_cache cache, blkid_dev dev) - __ul_attribute__((nonnull)); +extern blkid_dev blkid_verify(blkid_cache cache, blkid_dev dev); /* read.c */ /* resolve.c */ extern char *blkid_get_tag_value(blkid_cache cache, const char *tagname, const char *devname) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern char *blkid_get_devname(blkid_cache cache, const char *token, const char *value) - __ul_attribute__((nonnull(1, 2))) __ul_attribute__((warn_unused_result)); /* tag.c */ extern blkid_tag_iterate blkid_tag_iterate_begin(blkid_dev dev) __ul_attribute__((warn_unused_result)); extern int blkid_tag_next(blkid_tag_iterate iterate, - const char **type, const char **value) - __ul_attribute__((nonnull)); -extern void blkid_tag_iterate_end(blkid_tag_iterate iterate) - __ul_attribute__((nonnull)); -extern int blkid_dev_has_tag(blkid_dev dev, const char *type, - const char *value) - __ul_attribute__((nonnull(1 ,2))); + const char **type, const char **value); +extern void blkid_tag_iterate_end(blkid_tag_iterate iterate); +extern int blkid_dev_has_tag(blkid_dev dev, const char *type, const char *value) + __ul_attribute__((nonnull(1,2))); + extern blkid_dev blkid_find_dev_with_tag(blkid_cache cache, const char *type, const char *value) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); -extern int blkid_parse_tag_string(const char *token, char **ret_type, - char **ret_val) - __ul_attribute__((nonnull)); + +extern int blkid_parse_tag_string(const char *token, char **ret_type, char **ret_val); /* version.c */ extern int blkid_parse_version_string(const char *ver_string) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern int blkid_get_library_version(const char **ver_string, - const char **date_string) - __ul_attribute__((nonnull)); + const char **date_string); /* encode.c */ -extern int blkid_encode_string(const char *str, char *str_enc, size_t len) - __ul_attribute__((nonnull)); -extern int blkid_safe_string(const char *str, char *str_safe, size_t len) - __ul_attribute__((nonnull)); +extern int blkid_encode_string(const char *str, char *str_enc, size_t len); +extern int blkid_safe_string(const char *str, char *str_safe, size_t len); /* evaluate.c */ -extern int blkid_send_uevent(const char *devname, const char *action) - __ul_attribute__((nonnull)); +extern int blkid_send_uevent(const char *devname, const char *action); extern char *blkid_evaluate_tag(const char *token, const char *value, blkid_cache *cache) - __ul_attribute__((nonnull(1, 2))) __ul_attribute__((warn_unused_result)); extern char *blkid_evaluate_spec(const char *spec, blkid_cache *cache) - __ul_attribute__((nonnull(1))) __ul_attribute__((warn_unused_result)); /* probe.c */ extern blkid_probe blkid_new_probe(void) __ul_attribute__((warn_unused_result)); extern blkid_probe blkid_new_probe_from_filename(const char *filename) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern void blkid_free_probe(blkid_probe pr); -extern void blkid_reset_probe(blkid_probe pr) - __ul_attribute__((nonnull)); +extern void blkid_reset_probe(blkid_probe pr); extern int blkid_probe_set_device(blkid_probe pr, int fd, - blkid_loff_t off, blkid_loff_t size) - __ul_attribute__((nonnull)); + blkid_loff_t off, blkid_loff_t size); extern dev_t blkid_probe_get_devno(blkid_probe pr) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern dev_t blkid_probe_get_wholedisk_devno(blkid_probe pr) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern int blkid_probe_is_wholedisk(blkid_probe pr) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_loff_t blkid_probe_get_size(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_loff_t blkid_probe_get_offset(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern unsigned int blkid_probe_get_sectorsize(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_loff_t blkid_probe_get_sectors(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern int blkid_probe_get_fd(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); /* * superblocks probing */ extern int blkid_known_fstype(const char *fstype) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern int blkid_superblocks_get_name(size_t idx, const char **name, int *usage); -extern int blkid_probe_enable_superblocks(blkid_probe pr, int enable) - __ul_attribute__((nonnull)); +extern int blkid_probe_enable_superblocks(blkid_probe pr, int enable); #define BLKID_SUBLKS_LABEL (1 << 1) /* read LABEL from superblock */ #define BLKID_SUBLKS_LABELRAW (1 << 2) /* read and define LABEL_RAW result value*/ @@ -310,12 +278,9 @@ extern int blkid_probe_enable_superblocks(blkid_probe pr, int enable) #define BLKID_SUBLKS_DEFAULT (BLKID_SUBLKS_LABEL | BLKID_SUBLKS_UUID | \ BLKID_SUBLKS_TYPE | BLKID_SUBLKS_SECTYPE) -extern int blkid_probe_set_superblocks_flags(blkid_probe pr, int flags) - __ul_attribute__((nonnull)); -extern int blkid_probe_reset_superblocks_filter(blkid_probe pr) - __ul_attribute__((nonnull)); -extern int blkid_probe_invert_superblocks_filter(blkid_probe pr) - __ul_attribute__((nonnull)); +extern int blkid_probe_set_superblocks_flags(blkid_probe pr, int flags); +extern int blkid_probe_reset_superblocks_filter(blkid_probe pr); +extern int blkid_probe_invert_superblocks_filter(blkid_probe pr); /** * BLKID_FLTR_NOTIN @@ -325,25 +290,21 @@ extern int blkid_probe_invert_superblocks_filter(blkid_probe pr) * BLKID_FLTR_ONLYIN */ #define BLKID_FLTR_ONLYIN 2 -extern int blkid_probe_filter_superblocks_type(blkid_probe pr, int flag, char *names[]) - __ul_attribute__((nonnull)); +extern int blkid_probe_filter_superblocks_type(blkid_probe pr, int flag, char *names[]); #define BLKID_USAGE_FILESYSTEM (1 << 1) #define BLKID_USAGE_RAID (1 << 2) #define BLKID_USAGE_CRYPTO (1 << 3) #define BLKID_USAGE_OTHER (1 << 4) -extern int blkid_probe_filter_superblocks_usage(blkid_probe pr, int flag, int usage) - __ul_attribute__((nonnull)); +extern int blkid_probe_filter_superblocks_usage(blkid_probe pr, int flag, int usage); /* * topology probing */ -extern int blkid_probe_enable_topology(blkid_probe pr, int enable) - __ul_attribute__((nonnull)); +extern int blkid_probe_enable_topology(blkid_probe pr, int enable); /* binary interface */ extern blkid_topology blkid_probe_get_topology(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern unsigned long blkid_topology_get_alignment_offset(blkid_topology tp) @@ -366,71 +327,57 @@ extern unsigned long blkid_topology_get_physical_sector_size(blkid_topology tp) * partitions probing */ extern int blkid_known_pttype(const char *pttype) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); -extern int blkid_probe_enable_partitions(blkid_probe pr, int enable) - __ul_attribute__((nonnull)); - -extern int blkid_probe_reset_partitions_filter(blkid_probe pr) - __ul_attribute__((nonnull)); -extern int blkid_probe_invert_partitions_filter(blkid_probe pr) - __ul_attribute__((nonnull)); -extern int blkid_probe_filter_partitions_type(blkid_probe pr, int flag, char *names[]) - __ul_attribute__((nonnull)); +extern int blkid_probe_enable_partitions(blkid_probe pr, int enable); +extern int blkid_probe_reset_partitions_filter(blkid_probe pr); +extern int blkid_probe_invert_partitions_filter(blkid_probe pr); +extern int blkid_probe_filter_partitions_type(blkid_probe pr, int flag, char *names[]); /* partitions probing flags */ #define BLKID_PARTS_FORCE_GPT (1 << 1) #define BLKID_PARTS_ENTRY_DETAILS (1 << 2) #define BLKID_PARTS_MAGIC (1 << 3) -extern int blkid_probe_set_partitions_flags(blkid_probe pr, int flags) - __ul_attribute__((nonnull)); +extern int blkid_probe_set_partitions_flags(blkid_probe pr, int flags); /* binary interface */ extern blkid_partlist blkid_probe_get_partitions(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern int blkid_partlist_numof_partitions(blkid_partlist ls) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_parttable blkid_partlist_get_table(blkid_partlist ls) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_partition blkid_partlist_get_partition(blkid_partlist ls, int n) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_partition blkid_partlist_devno_to_partition(blkid_partlist ls, dev_t devno) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_parttable blkid_partition_get_table(blkid_partition par) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern const char *blkid_partition_get_name(blkid_partition par) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern const char *blkid_partition_get_uuid(blkid_partition par) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern int blkid_partition_get_partno(blkid_partition par) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_loff_t blkid_partition_get_start(blkid_partition par) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_loff_t blkid_partition_get_size(blkid_partition par) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern int blkid_partition_get_type(blkid_partition par) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern const char *blkid_partition_get_type_string(blkid_partition par) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern unsigned long long blkid_partition_get_flags(blkid_partition par) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern int blkid_partition_is_logical(blkid_partition par) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); @@ -440,41 +387,33 @@ extern int blkid_partition_is_extended(blkid_partition par) extern int blkid_partition_is_primary(blkid_partition par) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern const char *blkid_parttable_get_type(blkid_parttable tab) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); + extern blkid_loff_t blkid_parttable_get_offset(blkid_parttable tab) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern blkid_partition blkid_parttable_get_parent(blkid_parttable tab) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); /* * NAME=value low-level interface */ -extern int blkid_do_probe(blkid_probe pr) - __ul_attribute__((nonnull)); -extern int blkid_do_safeprobe(blkid_probe pr) - __ul_attribute__((nonnull)); -extern int blkid_do_fullprobe(blkid_probe pr) - __ul_attribute__((nonnull)); +extern int blkid_do_probe(blkid_probe pr); +extern int blkid_do_safeprobe(blkid_probe pr); +extern int blkid_do_fullprobe(blkid_probe pr); extern int blkid_probe_numof_values(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); extern int blkid_probe_get_value(blkid_probe pr, int num, const char **name, - const char **data, size_t *len) - __ul_attribute__((nonnull(1))); + const char **data, size_t *len); extern int blkid_probe_lookup_value(blkid_probe pr, const char *name, - const char **data, size_t *len) - __ul_attribute__((nonnull(1, 2))); + const char **data, size_t *len); extern int blkid_probe_has_value(blkid_probe pr, const char *name) __ul_attribute__((nonnull)) __ul_attribute__((warn_unused_result)); -extern int blkid_do_wipe(blkid_probe pr, int dryrun) - __ul_attribute__((nonnull)); +extern int blkid_do_wipe(blkid_probe pr, int dryrun); /* * Deprecated functions/macros @@ -491,23 +430,18 @@ extern int blkid_do_wipe(blkid_probe pr, int dryrun) #define BLKID_PROBREQ_VERSION BLKID_SUBLKS_VERSION extern int blkid_probe_set_request(blkid_probe pr, int flags) - __ul_attribute__((nonnull)) __ul_attribute__((deprecated)); extern int blkid_probe_filter_usage(blkid_probe pr, int flag, int usage) - __ul_attribute__((nonnull)) __ul_attribute__((deprecated)); extern int blkid_probe_filter_types(blkid_probe pr, int flag, char *names[]) - __ul_attribute__((nonnull)) __ul_attribute__((deprecated)); extern int blkid_probe_invert_filter(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((deprecated)); extern int blkid_probe_reset_filter(blkid_probe pr) - __ul_attribute__((nonnull)) __ul_attribute__((deprecated)); #endif /* BLKID_DISABLE_DEPRECATED */ |