Usageopendns

Package'pingr'June22,2020TitleCheckifaRemoteComputerisUpVersion2.
0.
1DescriptionCheckifaremotecomputerisup.
Itcaneitherjustcallthesystempingcommand,orcheckaspeciedTCPport.
LicenseMIT+leLICENSELazyDatatrueURLhttps://github.
com/r-lib/pingr#readmeBugReportshttps://github.
com/r-lib/pingr/issuesSuggestscovr,testthatImportsprocessx,utilsRoxygenNote7.
1.
0.
9000EncodingUTF-8NeedsCompilationyesAuthorGáborCsárdi[aut,cre]MaintainerGáborCsárdiRepositoryCRANDate/Publication2020-06-2217:40:03UTCRtopicsdocumented:pingr-package2apple_captive_test2is_online3my_ip3nsl4ping5ping_port6Index812apple_captive_testpingr-packageCheckifthelocalorremotecomputerisupDescriptionCheckifaremotecomputerisup.
Itcaneitherjustcallthesystempingcommand,orcheckaspeciedTCPport.
Author(s)Maintainer:GáborCsárdiSeeAlsoUsefullinks:https://github.
com/r-lib/pingr#readmeReportbugsathttps://github.
com/r-lib/pingr/issuesapple_captive_testDownloadApple'scaptiveportaltestDescriptionIfthetestpage,returns"Success"thatmeansthatthecomputerisconnectedtotheInternet.
Usageapple_captive_test()DetailsNotethatthisfunctionwillfailifthecomputerisofine.
Useis_online()tocheckifthecomputerisonline.
Examplesapple_captive_test()is_online3is_onlineIsthecomputeronlineDescriptionCheckifthecomputerisonline.
Itdoesthreetries:RetrieveApple'sCaptivePortaltestpage,seeapple_captive_test().
Queriesmyip.
opendns.
comonOpenDNS,seemy_ip().
Retrievesicanhazip.
comviaHTTPS,seemy_ip().
Ifanyofthesearesuccessful,itreturnsTRUE.
Usageis_online(timeout=1)ArgumentstimeoutTimeoutforthequeries.
(Note:itiscurrentlynotusedfortheDNSquery.
)ValuePossiblevalues:TRUEYes,online.
FALSENo,notonline.
Examplesis_online()my_ipQuerythecomputer'spublicIPaddressDescriptionItcanuseaDNSquerytoopendns.
com,ifmethod=="dns",oranHTTPSquerytoicanhazip.
com,seehttps://github.
com/major/icanhaz.
TheDNSqueryismuchfaster,theHTTPSqueryissecure.
Usagemy_ip(method=c("dns","https"))4nslArgumentsmethodWhethertouseaDNSorHTTPSquery.
ValueComputer'spublicIPaddressasastring.
Examplesmy_ip()my_ip(method="https")nslDNSqueryDescriptionPerformaDNSqueryforadomain.
Itsupportscustomnameservers,andqueryingDNSrecordsofcertainclassandtype.
Usagensl(domain,server=NULL,type=1L,class=1L)ArgumentsdomainDomaintoquery.
serverCustomnameserverIPaddress,touse.
NotethatthismustbeanIPaddresscurrently.
E.
g.
8.
8.
8.
8isGoogle'sDNSserver.
typeRecordtypetoquery,anintegerscalar.
1LisanArecord,28LisanAAAArecord,etc.
Seee.
g.
https://en.
wikipedia.
org/wiki/List_of_DNS_record_typesfortherecordtypes.
classQueryclass.
Thisisusually1L,i.
e.
"Internet".
Seee.
g.
https://www.
iana.
org/assignments/dns-parameters/dns-parameters.
xhtml#dns-parameters-2forallDNSclasses.
ValueAlistoftwoentriescurrently,additionalentriesmightbeaddedlater:answer:adataframeofDNSrecords,withcolumns:name,class,type,ttl,data.
dataisalistcolumnandcontainstheIP(6)addressforAandAAAArecords,butitcontainsotherdata,e.
g.
hostnameforCNAME,forotherrecords.
Ifpingrcouldnotparsearecord(itonlyparsesthemostcommonrecordstypes:A,AAAA,NA,PTR,CNAME,TXT,MX,SOA),thenthedataoftherecordisincludedasarawvector.
flags:anamedlogicalvectorofagsaa,tc,rd,ra,ad,cd.
SeetheRFC(https://www.
ietf.
org/rfc/rfc1035.
txt)forthese.
OnWindowstheyareallsettoNAcurrently.
ping5Examplesnsl("r-project.
org")nsl("google.
com",type=28L)pingPingaremoteserver,toseeifitisaliveDescriptionThisistheclassicping,usingICMPpackages.
OnlythesystemadministratorcansendICMPpackages,sowecallouttothesystem'spingutility.
Usageping(destination,continuous=FALSE,verbose=continuous,count=3L,timeout=1)ArgumentsdestinationHostnameorIPaddress.
continuousLogical,whethertokeeppinginguntiltheuserinterrupts.
verboseWhethertoprintprogressonthescreenwhilepinging.
countNumberofpingstoperform.
timeoutTimeoutforapingresponse.
ValueVectorofresponsetimes.
NAmeansnoresponse,inmilliseconds.
CurrentlyNAsarealwaysattheendofthevector,andnotintheircorrectposition.
Examplesping("8.
8.
8.
8")ping("r-project.
org")6ping_portping_portCheckifaportofaserverisactive,measureresponsetimeDescriptionCheckifaportofaserverisactive,measureresponsetimeis_up()checksifawebserverisup.
Usageping_port(destination,port=80L,continuous=FALSE,verbose=continuous,count=3L,timeout=1)is_up(destination,port=80,timeout=0.
5,fail_on_dns_error=FALSE,check_online=TRUE)ArgumentsdestinationHostnameorIPaddress.
portPort.
continuousLogical,whethertokeeppinginguntiltheuserinterrupts.
verboseWhethertoprintprogressonthescreenwhilepinging.
countNumberofpingstoperform.
timeoutTimeout,inseconds.
Howlongtowaitforapingtosucceed.
fail_on_dns_errorIfTRUEthenis_up()failsiftheDNSresolutionfails.
OtherwiseitwillreturnFALSE.
check_onlineWhethertocheckrstifthecomputerisonline.
Otherwiseitispossiblethatthecomputerisbehindaproxy,thathijackstheHTTPconnectiontodestination.
ValueVectorofresponsetimes,inmilliseconds.
NAmeansnoresponsewithinthetimeout.
ping_port7Examplesping_port("r-project.
org")is_up("google.
com")is_up("google.
com",timeout=0.
01)Indexapple_captive_test,2apple_captive_test(),3is_online,3is_online(),2is_up(ping_port),6my_ip,3my_ip(),3nsl,4ping,5ping_port,6pingr(pingr-package),2pingr-package,28