Mirror of :pserver:cvs@cvs.fefe.de:/cvs libowfat https://www.fefe.de/libowfat/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 

36 lines
1.0 KiB

  1. .TH fmt_ip6ifc 3
  2. .SH NAME
  3. fmt_ip6ifc \- write a formatted ASCII representation of an IPv6 number
  4. .SH SYNTAX
  5. .B #include <ip6.h>
  6. unsigned int \fBfmt_ip6ifc\fP(char *\fIdest\fR,const char \fIip\fR[16],uint32 \fIscope_id\fR);
  7. .SH DESCRIPTION
  8. fmt_ip6ifc formats an IPv6 number in ASCII representation from \fIip\fR and
  9. writes the result into \fIdest\fR. It returns the number of bytes
  10. written.
  11. fmt_ip6ifc will apply "::" compression to the output.
  12. If \fIip\fR is an IPv4-mapped IPv6 address, fmt_ip6ifc will output it as
  13. IPv4 address.
  14. If \fIdest\fR equals FMT_LEN (i.e. is zero), fmt_ip6ifc returns the number
  15. of bytes it would have written.
  16. fmt_ip6 does not append \\0.
  17. ip6.h defines the integer IP6_FMT to be big enough to contain every
  18. possible fmt_ip6 output plus \\0. However, for fmt_ip6ifc you need to
  19. add 1 for the '%' and IF_NAMESIZE from <net/if.h> for the interface
  20. name.
  21. .SH EXAMPLE
  22. #include <ip6.h>
  23. char buf[IP6_FMT];
  24. char ip[16];
  25. scope_id sid;
  26. buf[fmt_ip6ifc(buf,ip,sid)]=0;
  27. .SH "SEE ALSO"
  28. scan_ip6(3), fmt_ip4(3)