.TH "KDK_GET_HARD_VENDOR" 3 "Thu Aug 10 2023" "Linux Programmer's Manual" \"
.SH NAME
kdk_get_hard_vendor - 获取硬盘序列号
.SH SYNOPSIS
.nf
.B #include <libkydiskinfo.h>
.sp
.BI "extern char* kdk_get_hard_vendor(const char *"diskname ");" 
.sp
Link with \fI\-lkydiskinfo\fP.
.SH "Detailed Description"
Based on the specified disk name 
.I diskname,
such as absolute path such as 
.I /dev/sda,
or 
.BR kdk_get_hard_disk()
function returns an element in the value to obtain hard drive manufacturer information.
.SH "RETURN VALUE"
On success, Returns the manufacturer of hard drive; The returned string needs to be released by 
.I free
.PP
On error, return
.BR NULL.
.SH EXAMPLES
.EX
#include "libkydiskinfo.h"
#include <stdio.h>
#include <stdlib.h>

static void display_disk_info(kdk_diskinfo *di)
{
    printf("---------------%s------------------\n", di->name);
    printf("Disk Sectors:\t%llu\n", di->sectors_num);
    printf("Disk Sector Size:\t%u\n", di->sector_size);
    printf("Disk Size:\t%f MiB\n", di->total_size_MiB);
    printf("Disk Model:\t%s\n", di->model ? di->model : "None");
    printf("Disk Serial:\t%s\n", di->serial ? di->serial : "None");
    printf("Disk Partition Number:\t%u\n", di->partition_nums);
    printf("Disk Type:\t%d\n", di->disk_type);
    printf("Disk fwrev:\t%s\n", di->fwrev);
}

static void display_disk_list(char **disklist)
{
    int count = 0;
    while (disklist[count])
    {
        printf("No. %d\t %s\n", count + 1, disklist[count]);
        count ++;
    }
}

int main()
{
    char **disklist = kdk_get_disklist();
    // display_disk_list(disklist);
    for (int i = 0; disklist[i]; i++)
    {
        kdk_diskinfo *sdainfo = kdk_get_diskinfo(disklist[i]);
        if (!sdainfo)
        {
            printf("[%s]Get disk info error.\n", disklist[i]);
            continue;
        }

        display_disk_info(sdainfo);

        kdk_free_diskinfo(sdainfo);
    }
    kdk_free_disklist(disklist);


    char **di = kdk_get_hard_disk();
    size_t num = 0;
    while (di[num])
    {
        printf("No. %ld\t %s\n", num + 1, di[num]);
        char *res = kdk_get_hard_disk_size(di[num]);
        printf("容量 = %s\n", res);
        free(res);

        res = kdk_get_hard_fwrev(di[num]);
        printf("固态版本 = %s\n", res);
        free(res);

        res = kdk_get_hard_vendor(di[num]);
        printf("厂商 = %s\n", res);
        free(res);

        res = kdk_get_hard_type(di[num]);
        printf("类型 = %s\n", res);
        free(res);

        res = kdk_get_hard_model(di[num]);
        printf("型号 = %s\n", res);
        free(res);

        res =kdk_get_hard_serial(di[num]);
        printf("序列号 = %s\n", res);
        free(res);

        num ++;
    }
    kdk_free_disklist(di);

    return 0;
}

.SH "CONFORMING TO"
These functions are as per the withdrawn POSIX.1e draft specification.
The following functions are Linux extensions:
.BR kdk_get_hard_disk (),
.BR kdk_free_disklist (),
.BR kdk_get_hard_disk_size (),
.BR kdk_get_hard_fwrev (),
.BR kdk_get_hard_type (),
.BR kdk_get_hard_model (),
and
.BR kdk_get_hard_serial ().
.SH "SEE ALSO"
.BR kdk_free_disklist (3),
.BR kdk_get_hard_disk_size (3),
.BR kdk_get_hard_fwrev (3),
.BR kdk_get_hard_type (3),
.BR kdk_get_hard_model (3),
.BR kdk_get_hard_serial (3),
.BR kdk_get_hard_disk (3).