Getaddrinfo - Getaddrinfo

The funktsiyalari getaddrinfo () va getnameinfo () aylantirish domen nomlari, xost nomlari va IP-manzillar uchun inson tomonidan o'qiladigan matnli tasvirlar va uchun tuzilgan ikkilik formatlar o'rtasida operatsion tizim tarmoq API'si. Ikkala funktsiya ham POSIX standart dastur dasturlash interfeysi (API).

getaddrinfo va getnameinfo bir-birining teskari funktsiyalari. Ular agnostik tarmoq protokoli bo'lib, ikkalasini ham qo'llab-quvvatlaydi IPv4 va IPv6. Bu protokoldan mustaqil dasturlarni yaratishda va IPv4-ning eski kodini IPv6 Internet-ga o'tkazishda nomni aniqlash uchun tavsiya etilgan interfeys.

Ichki sifatida funktsiyalar Domen nomlari tizimi (DNS) kabi boshqa, quyi darajadagi funktsiyalarni chaqirish orqali gethostbyname ().

2016 yil 16 fevralda xavfsizlik xatosi e'lon qilindi glibc a yordamida getaddrinfo () ni amalga oshirish buferni to'ldirish tajovuzkor tomonidan o'zboshimchalik bilan kod bajarilishiga imkon beradigan usul.[1]

struct addrinfo

The C tarmoq API-sidagi manzillar va xost nomlarini ko'rsatish uchun foydalaniladigan ma'lumotlar tarkibi quyidagilar:

struct addrinfo {int ai_flags; int ai_family; int ai_socktype; int ai_protocol; socklen_t ai_addrlen; struct sockaddr * ai_addr; char * ai_canonname; / * kanonik ism * / struct addrinfo * ai_next; / * ushbu struktur bog'langan ro'yxatni tuzishi mumkin * /};

Ba'zi eski tizimlarda ai_addrlen bu hajmi_t o'rniga nilufar. Kabi ko'plab soket funktsiyalari qabul qilish () va getpeername (), parametr turiga ega bo'lishini talab qiladi socklen_t * va dasturchilar ko'pincha manzilni ai_addrlen elementi addrinfo tuzilishi. Agar turlar mos kelmasa, masalan, 64 bitli Solaris 9 tizim qaerda hajmi_t 8 bayt va nilufar 4 baytni tashkil qiladi, keyin ish vaqtidagi xatolarga olib kelishi mumkin.

Tarkibi tarkibida tuzilmalar mavjud ai_family va sockaddr o'zi bilan sa_family maydon. Ushbu funktsiya bilan tuzilishda ular bir xil qiymatga o'rnatiladi getaddrinfo ba'zi dasturlarda.

getaddrinfo ()

getaddrinfo () inson tomonidan o'qiladigan matn satrlarini o'zgartiradi xost nomlari yoki IP-manzillar ichiga dinamik ravishda ajratilgan bog'langan ro'yxat Ushbu funktsiya uchun funktsiya prototipi quyidagicha ko'rsatilgan:

int getaddrinfo (const char * hostname, const char * service, const struct addrinfo * maslahatlar, struct addrinfo ** res);
xost nomi
yoki "example.com" kabi domen nomi, yoki "127.0.0.1" yoki NULL kabi manzil satri bo'lishi mumkin, bu holda ko'rsatmalar bayroqlariga qarab 0.0.0.0 yoki 127.0.0.1 manzili tayinlanadi.
xizmat
"80" kabi qator sifatida berilgan port raqami yoki xizmat nomi bo'lishi mumkin, masalan. "echo". Ikkinchi holatda odatiy dastur qo'llaniladi getservbyname () faylni so'rash uchun / etc / services xizmatni port raqamiga hal qilish uchun.
maslahatlar
yoki NULL yoki an bo'lishi mumkin addrinfo so'ralgan xizmat turi bilan tuzilishi.
res
yangisini ko'rsatuvchi ko'rsatkichdir addrinfo funktsiya muvaffaqiyatli bajarilgandan so'ng so'ralgan ma'lumotlar bilan tuzilish.[2] Funktsiya muvaffaqiyatsizlikka 0 qaytaradi va bajarilmasa nolga teng bo'lmagan xato qiymati.[3]

Amalga oshirish platformalar orasida turlicha bo'lishiga qaramay, funktsiya avval portlash raqamini odatda tarmoqlanib olish uchun harakat qiladi xizmat. Agar satr qiymati raqam bo'lsa, uni butun songa aylantiradi va chaqiradi htons (). Agar bu xizmat nomi bo'lsa, masalan www, xizmatga qarashadi getservbyname (), dan olingan protokoldan foydalangan holda maslahatlar -> ai_socktype bu funktsiya uchun ikkinchi parametr sifatida. Keyin, agar xost nomi berilgan (NULL emas), qo'ng'iroq gethostbyname () uni hal qiladi, yoki boshqa manzil 0.0.0.0 ishlatiladi, agar maslahatlar -> ai_flags ga o'rnatildi AI_PASSIVEva 127.0.0.1 aks holda. Bu yangisini ajratdi addrinfo tegishli bilan to'ldirilgan tuzilish sockaddr_in ushbu shartlardan birida, shuningdek, boshida olingan portni unga qo'shib qo'yadi. Va nihoyat ** res parametr yangi ajratilgan joyga ishora qilish uchun ajratilgan addrinfo tuzilishi.[4] Mac OS uchun Unix versiyasi kabi ba'zi bir dasturlarda maslahatlar -> ai_protocol bekor qiladi maslahatlar -> ai_socktype boshqalarda esa buning aksi, shuning uchun ikkala kod bir nechta platformalarda ishlashi uchun ekvivalent qiymatlar bilan aniqlanishi kerak.

freeaddrinfo ()

Ushbu funktsiya funktsiya bilan ajratilgan xotirani bo'shatadi getaddrinfo (). Ikkinchisining natijasi sifatida manzildan boshlangan addrinfo tuzilmalarining bog'langan ro'yxati keltirilgan ai, freeaddrinfo () ro'yxatni ko'rib chiqadi va har birini navbat bilan ozod qiladi.

void freeaddrinfo (struct addrinfo * ai);

getnameinfo ()

Funktsiya getnameinfo () ko'rsatgich shaklidagi IP-manzilning ichki ikkilik ko'rinishini a ga o'zgartiradi struct sockaddr xost nomidan tashkil topgan matn satrlariga yoki agar manzilni nom bilan hal qilib bo'lmaydigan bo'lsa, IP-manzilning matnli vakili, shuningdek xizmat portining nomi yoki raqami. Funktsiya prototipi quyidagicha ko'rsatilgan:

int getnameinfo (const struct sockaddr * sa, socklen_t salen, char * host, size_t hostlen, char * serv, size_t servlen, int bayroqlar);

Misol

Quyidagi misoldan foydalaniladi getaddrinfo () domen nomini hal qilish uchun www.example.com manzillar ro'yxatiga kiring va keyin qo'ng'iroq qiling getnameinfo () har bir natijada manzilning kanonik nomini qaytarish. Umuman olganda, bu asl nusxani ishlab chiqaradi xost nomi, agar ma'lum bir manzilda bir nechta ism bo'lmasa, u holda kanonik ism qaytarildi. Ushbu misolda domen nomi uch marta, olingan har uch natijaning har biri uchun bir marta bosiladi.

#include  #include  #include  #include  #include  #ifndef NI_MAXHOST # define NI_MAXHOST 1025 # endifint main ( bekor) {struct addrinfo * natija; struct addrinfo * res; int xatosi; / * domen nomini manzillar ro'yxatida hal qilish * /    error = getaddrinfo ("www.example.com", NULL, NULL, & result);    if (error! = 0) {if (error == EAI_SYSTEM) {perror ("getaddrinfo"); } else {fprintf (stderr, "getaddrinfo-dagi xato:% s  n", gai_strerror (xato)); } chiqish (EXIT_FAILURE); } / * barcha qaytarilgan natijalar bo'ylab aylantiring va teskari qidiruvni amalga oshiring * / for (res = result; res! = NULL; res = res-> ai_next) {char hostname [NI_MAXHOST];        error = getnameinfo (res-> ai_addr, res-> ai_addrlen, xost nomi, NI_MAXHOST, NULL, 0, 0);         if (error! = 0) {fprintf (stderr, "getnameinfo-dagi xato:% s  n", gai_strerror (xato)); davom ettirish; } if (* xostname! = ' 0') printf ("xostname:% s  n", xost nomi); }     freeaddrinfo (natija);    return 0;}

Shuningdek qarang

Adabiyotlar

  1. ^ https://googleonlinesecurity.blogspot.ca/2016/02/cve-2015-7547-glibc-getaddrinfo-stack.html
  2. ^ Stivens R., Fenner, Rudoff [2003] UNIX® Tarmoq dasturlash hajmi 1-jild, Uchinchi nashr: Sockets Networking API. Nashriyotchi: Addison-Uesli Professional. Pub. Sana: 2003 yil 14-noyabr. 256
  3. ^ http://pubs.opengroup.org/onlinepubs/9699919799/ Kirish 31.5.2018
  4. ^ Hajimu UMEMOTO [2000] getaddrinfo.c Kirish: https://opensource.apple.com/source/passwordserver_sasl/passwordserver_sasl-14/cyrus_sasl/lib/getaddrinfo.c

Tashqi havolalar

  • RFC 3493, IPv6 uchun asosiy soket interfeysi kengaytmalari