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.
 
 
 
 

33 lines
1.1 KiB

  1. .TH fmt_ip6_flat 3
  2. .SH NAME
  3. fmt_ip6_flat \- write a formatted ASCII representation of an IPv6 number
  4. .SH SYNTAX
  5. .B #include <ip6.h>
  6. unsigned int \fBfmt_ip6_flat\fP(char *\fIdest\fR,const char \fIip\fR[16]);
  7. .SH DESCRIPTION
  8. fmt_ip6_flat formats an IPv6 number in a flat ASCII representation from
  9. \fIip\fR and writes the result into \fIdest\fR. It returns the number of
  10. bytes written (always 32).
  11. This representation does not contain colons and is meant to be easily
  12. machine-readable. Use fmt_ip6 for the normal (standard) representation.
  13. This function is meant for places which use colons to separate fields
  14. and thus have problems interpreting the standard IPv6 notation.
  15. If \fIdest\fR equals FMT_LEN (i.e. is zero), fmt_ip6_flat returns the
  16. number of bytes it would have written.
  17. fmt_ip6_flat does not append \\0.
  18. For convenience, ip6.h defines the integer IP6_FMT to be big enough to
  19. contain every possible fmt_ip6_flat output plus \\0.
  20. .SH EXAMPLE
  21. #include <ip6.h>
  22. char buf[IP6_FMT];
  23. char ip[16];
  24. buf[fmt_ip6_flat(buf,ip)]=0;
  25. .SH "SEE ALSO"
  26. scan_ip6_flat(3), fmt_ip6(3)